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Preface 


About the manual 


he product described in this manual is DR DOS, a disk operating 
system (DOS) which is designed to run on Intel 8088, 80286, i386, i486, 
and compatible microprocessors. 


This manual is intended for people who are using DR DOS for 
the first time, and for those people who are already familiar 
with DOS but want information on this version. 


Before you start using DR DOS, read your manufacturer’s 
handbook, so that you are reasonably familiar with your 
computer and how it works. 
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Finding your way around 


If you are new to personal computer operating systems, you 
should read the first four chapters of this manual in order of 
content. They are written with the new user in mind, and build 
upon each other. The remaining chapters contain more detailed 
information on specific uses of, and commands within DR DOS. 
If you are more experienced, after reading Chapter 1, you may 
find you want to skip to Chapter 5 and continue from there. 


Below is a summary of the individual chapters and appendices. 
Those chapters that people new to PC operating systems should 
read are indicated with this symbol j. 


Structure of the manual 
Chapter 1 Getting started with DR DOST 


Chapter 1 begins by explaining certain concepts you should be 
familiar with before installing and using the DR DOS operating 
system. It then describes how to install DR DOS and how to 
take backup copies of your installation diskettes. 


Chapter 2 Basic command concepist 


Chapter 2 describes the basic things you need to know about 
DR DOS commands to get started using them. It explains 
command structure and how to enter commands. 


Chapter 3 Organizing your informationt 


In Chapter 3 you will learn how to organize your data into files 
and directories for ease of access, how to name files and 
directories, and how to access them using paths. It also lists 
some DR DOS commands used to create and work with files 
and directories. 


Chapter 4 Protecting your informationt 


This chapter contains important information about protecting 
your data from unauthorized access or accidental loss by using 
passwords or by backing up information onto diskettes for 
future reference. 
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Chapter 5 The EDITOR 


Chapter 5 explains about the easy-to-use editor within DR DOS 
that you can use to create text files. 


Chapter 6 Redirecting input and output 


Instead of your keyboard input being sent to your screen, you 
can send it directly to a printer or file. You can also filter the 
output from your computer using a mechanism called piping. 
For example you may want the output of a program to be the 
input for another program. Chapter 6 explains how you can do 
this. 


Chapter 7 Grouping commands in batch files 


This chapter explains how to create and work with batch files, 
which enable you to store frequently-used sets of commands in 
one file. 


Chapter 8 DR DOS commands 


Chapter 8 contains an alphabetical list of all the DR DOS 
commands including their full command structure and what 
they are used for, with examples of usage. 


Chapter 9 Customizing your system 


At some point in the future you may want to change your 
system configuration, for example if you add a new printer. 
Chapter 9 explains how to use the SETUP program to do this. 
It also describes the two main configuration files: config.sys 
and autoexec.bat. 


Chapter 10 Setting up code page switching 


DR DOS allows you to change between different character sets, 
so that you can work with documents in different languages 
using a mechanism called code page switching. This chapter 
explains how to set up code page switching on your system. 
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Appendix A Error messages and troubleshooting 


Appendix A contains a full list of error and system messages 
generated by DR DOS and its associated utilities. Each 
message has a simple explanation and where possible a 
solution. There is also a section on what to do if things go 
wrong. 


Appendix B Character sets for code pages supported b 
Sei as pag pp y 


In this appendix is a list of all the different code page character 
sets supported by DR DOS. 


Appendix C Memory management 


This appendix explains the different types of memory, and how 
you can use DR DOS to make better use of memory on your 
computer. 


Appendix D The SID debugging tool 


This appendix explains the programmers’ symbolic debugging 
tool “SID". 


Glossary 


The glossary contains descriptions of terms found within the 
manual. 
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Quick Reference Table 
To learn about Look in 
ANSI escape sequences Chapter 9 
Assigning passwords Chapter 4 
Autoexec.bat file Chapter 9 
Batch processing Chapter 7 
Changing your configuration Chapter 9 
Code page switching Chapter 10 
Command syntax and usage Chapters 2 & 8 
Config.sys file Chapter 9 
Copying disks Chapters 1 & 4 
Debugging programs Appendix D 
Directories Chapter 3 
Disks Chapter 1 
Editing the command line Chapter 8 
Editing text files Chapter 5 
Error messages Appendix A 
Files Chapter 3 
Filters and pipes Chapter 6 
Formatting diskettes Chapters 1 & 4 
Installing DR DOS Chapter 1 
Installable device drivers Chapter 9 
Memory management Appendix C 
Paths Chapter 3 
Redirecting input and output Chapter 6 
SETUP program Chapter 9 
SID debugging program Appendix D 
Storing your data Chapter 4 


Wildcard characters 


Chapter 3 
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New features of this version of DR DOS 


If you are familiar with an earlier version of DR DOS you will 
find that this version includes some significant advances in 
DOS technology. The main additions are listed in this section. 


Transferring files between computers with FILELINK 


The FILELINK file transfer utility allows programs and data to 
be easily transferred from one computer to another, using a 
serial cable; see Chapter 8. 


Advanced memory management 


EMM386.SYS 


This is the DR DOS LIM 4.0 driver which converts extended 
memory into expanded memory on Intel i386, and i486-based 
computers. EMM386.SYS has been extended to allow the DR 
DOS kernel to be located in upper memory, or above 1 Mbyte, to 
increase the memory available to applications. It also supports 
the use of upper memory between 640 Kbyte and 1 Mbyte to 
load device drivers, TSRs (Terminate-Stay-Resident programs), 
and networking software. This can be achieved using the 
HIDEVICE, HIINSTALL and HILOAD commands. By 
supporting the Virtual Control Program Interface (VCPI), other 
i386 applications, like Lotus 1-2-3, can also run when this 
driver is loaded; see Chapter 9. 


HIDEVICE 


HIDEVICE allows you to load device drivers into upper 
memory, if available, during startup. The EMM386.SYS or 
HIDOS.SYS device driver must be loaded first; see Chapter 9. 


HIDOS.SYS 


This command allows users of Intel 80286-based computers to 
load the DR DOS kernel into the high memory above 1 Mbyte 
(if the computer has more than 1 Mbyte of memory). It also 
allows users with computers based on the Chips & Technologies 
LeAPSet, LeAPSetsx, NEAT, and NEATsx chip sets, to access 
the upper memory between 640 Kbyte and 1 Mbyte to load 
drivers, TSRs (Terminate-Stay-Resident programs), and 
networking software. This can be achieved using the 
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HIDEVICE, HIINSTALL and HILOAD commands; see 
Chapter 9. 


HIINSTALL 


This command allows utilities, such as CACHE and KEYB, to 
be loaded into upper memory, if available, at startup. The 
EMM386.8YS or HIDOS.SYS drivers must be loaded first; see 
Chapter 9. 


HILOAD 


HILOAD allows utilities and network drivers such as Novell, 
IPX and NETS, to be loaded from batch files, or the command 
line, into upper memory, if available. The EMM386.SYS or 
HIDOS.SYS device driver must be loaded before this can be 
used; see Chapters 8 and 9. 


MEM 


The MEM command displays the amount of used and free 
conventional, extended and expanded memory. It also displays 
where in memory programs, data and drivers are located, in 
both text and graphical form; see Chapter 8. 


Other new commands and utilities supplied with DR DOS 


CACHE.EXE 


This is a powerful disk cacheing utility which can utilize 
conventional, expanded, or extended memory to buffer disk 
reads. You can use it from the command line, or use the SETUP 
program to install it; see Chapters 8 and 9. 


CHAIN 


This command allows you to transfer control to another 
configuration file at startup in config.sys processing. 


CURSOR 


The CURSOR command allows users to set the cursor blink 
rate on display types such as LCDs (Liquid Crystal Displays). 
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ECHO 


ECHO allows you to display messages on screen during the 
startup procedure in config.sys processing. 


EXE2BIN 


This utility allows programmers to convert a .exe executable 
file to either a binary image file (.bin), or a .com executable 
file; see Chapter 8. 


JOIN 


JOIN allows disk drives to be joined, so that they actually 
appear as one drive; see Chapter 8. 


Enhanced commands 


EDITOR 


The DR DOS full screen text editor now supports block editing 
functions, you can copy, move, and delete blocks of text. It also 
allows you to incorporate a file into your text, and write a block 
of text to a separate file; see Chapter 5. 


The INSTALL program 


The installation procedure has been made even simpler, by 
giving you the option to use default settings for a small, 
medium or large DR DOS system (you can still configure each 
setting if you wish). The INSTALL program supports all of the 
new features of this DR DOS release. 


MODE 

There are two new options for the MODE command in this 
release of DR DOS. The first option: 

MODE [displaymode],m[,T], 

allows you to center the data on a CGA (Color Graphic Adapter) 
monitor (as some CGA screens do not display information 
properly). 

The second new option: 

MODE CONT[:] [LINES=lines] [COL=cols] [RATE=r DELAY=d] 


allows you to set the number of columns and lines on a display, 
and to set the keyboard typematic rate (that is the rate at 
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which characters are echoed to the screen when a key is held 
down); see Chapter 8. 


NLSFUNC 


NLSFUNC provides support for extended country information, 
and allows you to use the CHCP command to select code pages 
for all devices set up to use them. 


In previous versions of DR DOS, NLSFUNC was loaded by 
default. With this version of DR DOS, NLSFUNC must be 
explicitly loaded before you can use the CHCP command; see 
Chapters 9 and 10. 


SHARE 


The SHARE command provides support for file sharing, and 
file record locking. In previous versions of DR DOS, the effects 
of SHARE were enabled by default. With this release of DR 
DOS, SHARE has to be explicitly loaded to allow file sharing. 
SHARE does not need to be loaded under DR DOS when large 
disk partitions over 32 Mbytes are in use. SHARE now has the 
/L option to allow you to specify the number of file locks 
required for your system; see Chapter 8. 


SETUP 


The DR DOS configuration program SETUP, has been made 
easier to use, by giving you the option to use default settings for 
a small, medium, or large DR DOS system (you can still 
configure each setting if you wish). The SETUP program also 
supports all of the new features of this release of DR DOS. 


SID 


In previous versions the DR DOS debugging tool was called 
SID86, it has been renamed to SID. SID automatically 
initializes its registers when loaded, and supports the G= 
syntax for use when performing a low-level hard disk format. 
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General enhancements 


Filelist support 


Many of the DR DOS utilities now support the @FILELIST 
option. This allows an ASCII file containing a list of files to be 
associated with the command to be executed. 


Conditional execution of config.sys statements 


You can now make any statements in your config.sys file 
conditional at startup by placing a ? in front of the relevant 
statement. You then have to answer Y or N to the statement 
during the startup procedure. 


Alternatively, you may place a message string after the 
question mark and before the statement, which you will be 
prompted with at startup. You can use these options with any of 
your config.sys file statements; see Chapter 9. 


For users of other DOS operating systems 


If you are new to DR DOS, but have used another DOS 
operating system, you will find many commands and utilities 
are familiar. However, DR DOS enhances many of the 
commands, and eases the use of your computer. Listed here are 
important and useful features which you may not be aware of. 


Built-in help 


With many DR DOS commands you can display information 
about their options by typing the command name followed by 
/H, for example CHKDSK /H. 


Protecting files 


With DR DOS you can assign passwords to your files and 
directories to prevent unauthorized access, using the 
PASSWORD command. 
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Displaying and searching for files 


You can display files in multiple subdirectories, using the XDIR 
command. 


You can search for a file or multiple occurrences of a file, and 
display the file’s location on your disk using the TREE 
command. 


Editing the command line 


DR DOS allows you to recall previously entered command lines 
for re-use. The number of lines that may be recalled can be 
chosen at installation or reconfigured later using the SETUP 
program. 


Full screen editing 


Instead of single line editing (like that provided in other DOS 
operating systems), DR DOS provides the EDITOR, which 
enables you to display and edit a full screen of text at a time. 


Deleting files 


You can delete files in multiple subdirectories and remove 
empty directories with a single command, using the XDEL 
command. 


When you wish to delete files and be extra sure you do not 
delete the wrong ones, you can use the ERAQ or DELQ 
command to cause DR DOS to prompt you for confirmation 
before deleting each file. 


Debugging program 


DR DOS has a debugging program called SID which is similar 
to debugging utilities in other DOS operating systems. It is 
described in Appendix D. 


Expanded Memory Specification 


DR DOS supports the LIM 4.0 Expanded Memory Specification 
on all Intel i386 and i486-based systems and on IBM Expanded 
Memory Adapters (XMA) or compatible memory boards. 
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Large hard disk support 


DR DOS supports hard disk partitions greater than 32 Mbytes. 
Disk partitions use an industry-standard partitioning scheme, 
and support up to 512 Mbyte per partition. 


Installing DR DOS 


The installation program for DR DOS (INSTALL) provides a 
series of menu screens to enable you to install DR DOS quickly 
and easily. Also changing your system configuration later is 
easy using the SETUP program. 


Running DR DOS from ROM 


Your computer may have DR DOS in ROM. In this case you will 
find that DR DOS is already installed on your computer and 
starts automatically when you power on. Running DR DOS 
from ROM also increases the amount of memory available for 
running applications. 


Extending your computer system 


You may wish to extend your computer system by adding extra 
hard disks, memory boards or 314" diskette drives. You should 
consult your dealer about what you can use with DR DOS if you 
are in any doubt. 
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Assumptions and conventions 


What you type in 
What you should type in on the screen is shown as follows: 
DISKCOPY a: a: 


The commands are shown in uppercase, and the remainder of 
the command line in lowercase for clarity. 


Screen messages 


Information on screen, like a system message, is shown like 
this: 

Insert diskette to format in drive A: 

and strike a key when ready 


File entries 


Example entries in files, for example an extract from the 
autoexec.bat, are shown as follows: 


keyb uk 
date 
time 
Callouts 
Look for callouts! Callouts in the margins direct your attention to specific items 


of information. 
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Warnings, cautions and notes 


Caution 


Warnings, cautions and notes incorporate information 
separated from the text. Warnings and cautions are used to 
advise of the risk of loss of data or other problems; warnings 
are more serious than cautions. Notes contain additional 
information. 


Examples 


Note 


If your keyboard has separate cursor control keys, marked with 
arrow keys pointing right, left, up and down, you can use these 
keys to move the cursor instead. 


Use this option with care, as it can lead to problems when 
used with certain application programs. 


WARNING Use the FORMAT command with care! It will erase 


everything on the diskette to be formatted. 


Keys you will use 


When you work with DR DOS, certain keys on your keyboard 
have specific meanings. 


The Enter key 


The key you use to make the computer carry out an instruction 
is the “Enter” key, sometimes called the “Return” key or 
“Carriage Return” key. It often has this symbol on the 
keytop. In this manual it is always referred to as the Enter key. 


The Ctrl and Alt keys 


The Ctrl (control) and Alt (alternative) keys are used to alter 
the meaning of another key. If you see Ctrl+A, you hold down 
the Ctrl key and then type A or whatever letter follows the + 
sign. You use the Alt key in the same way. 


If you see Ctrl+Alt+Del, hold down Ctrl and Alt, and then 
press the Del key. This restarts DR DOS. 
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Commands 


For clarity this manual shows DR DOS commands in uppercase 
letters, and filenames and options in lowercase, but DR DOS 
itself ignores case when it reads the command line. 


Every command that you type in DR DOS needs to be followed 
by the Enter key. This is assumed in all chapters after Chapter 
1. Sometimes when commands are being carried out, you may 
be prompted to respond to a query by typing a single letter, Y 
for YES or N for NO. 


For example if you are copying diskettes using the command 
DISKCOPY, when the diskette has been copied you are asked: 


Copy another diskette (Y/N)? 


Disks and diskettes 


Unless otherwise stated in the text, disk refers to any kind of 
disk, hard, floppy or memory. 


Floppy disks are called diskettes and the term diskette refers to 
either 544" or 312" diskettes. 


Most of the examples in this manual assume that your 
computer has one hard disk (labeled “drive C”) and one diskette 
drive (labeled “drive A”). DR DOS works equally well on a 
computer with twin-diskette drives, computers with a hard disk 
and one diskette drive, and on computers with more than one 
hard disk. 
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Getting started with 
DR DO 


HIS chapter is your starting point with DR DOS. If you are more 

experienced, you can go straight to section 1.4. The DR DOS 
installation procedure is very easy to follow and has full context-sensitive 
help available at all stages; simply press the F1 function key for assistance. 


If you are not experienced with using personal computer 
operating systems, you may find it helpful to read sections 1.1, 
1.2, and 1.3 first. 
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1.1 Essential concepts 


This section explains some concepts which you need to be 
familiar with before you begin using DR DOS. 


Memory 


Types of RAM memory 


Every computer must have memory to store programs and 
information, and to load and run programs. The type of 
memory used to hold programs and data while the computer is 
switched off, is called storage memory. The type of memory 
used to load and run programs, is called Random Access 
Memory (or RAM for short). RAM can be thought of as the 
computer’s workspace. The more complex a task you want to 
do, the more RAM memory your computer needs. 


There are several types of RAM memory including: 
Conventional (or base) 

Upper memory 

High memory 

Extended 

(J Expanded 


Conventional memory is where you run most of your programs 
and utilities, and is usually where your operating system is 
loaded. The maximum amount of conventional memory 
available is normally 640 Kbytes. However, this barrier can be 
overcome by using Extended memory which is memory above 
1 Mbyte. 


Another way of accessing more memory is to use expanded 
memory or EMS memory (Expanded Memory Specification). 
Expanded memory enables you to run programs which 
manipulate large amounts of data, and which would otherwise 
not run efficiently in conventional memory. Programs have to 
be designed specifically to access it. 


Any memory addressed between 640 Kbytes and 1 Mbyte is 
known as upper memory. Upper memory is 384 Kbytes in size. 
Some sections of upper memory are used by various parts of 
your computer’s hardware. 


oood 


Types of disk 


Disks 


1: Getting started with DR DOS 3 


High memory is the first 64 Kbytes of extended memory. Within 
DR DOS there are several commands that can make use of 
upper and high memory. 


Appendix C has more information on all these memory types. 


It is important that you understand the difference between disk 
and memory storage. The memory in your computer is used for 
temporary storage. This means “in most cases” when you switch 
your computer off, the data stored in it is lost. Disk drives are 
designed for permanent information storage. 

When you start working with DR DOS you will be using two or 
three types of disk to store information: 


“1 Hard disks 
1) Diskettes 
(1 Memory disks 


Hard disks 


Hard disks are permanently fixed inside your computer (they 
are sometimes referred to as fixed disks because of this). These 
disks can store a lot of information, and can access the 
information from memory much faster than diskettes. Hard 
disks come in many sizes, typically allowing 20 or 40 Mbytes to 
be stored. Hard disks have to be partitioned before they can be 
used, that is separated electronically into sections. You then 
load your operating system, like DR DOS, into a partition. You 
can have a partition up to 512 Mbytes in size, and you may 
have several partitions on one hard disk. 


Diskettes 


Diskettes (or “floppy” disks) are removable disks which come in 
various sizes and capacities. The two main sizes are: 514" and 
3 14". The physical capacity of diskettes range from 360 Kbytes 
to 1.2 Mbytes for 54" diskettes, and for 31%" diskettes from 
720 Kbytes to 1.44 Mbytes. New blank diskettes need to be 
formatted before you can use them. 
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5 14" diskette front view 


The 3 14" diskettes are more compact than 51/4" diskettes. They 
can store as much as a 5/4" diskette or even more. They have 
solid plastic covers and a protective metal shield to prevent 
dust getting to the diskette surface. 


3 14" diskette front view 
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The do’s and don‘ts of handling diskettes 


Do’s: 
Do 
Do 


Do 


Do 


Don'ts: 
Don’t 


Don’t 


Don’t 
Don’t 


Don’t 
Don’t 


Don’t 
Don’t 


Hold diskettes at the corner. 


Use a felt tip pen to write the diskette label 
before sticking it onto the diskette, and if 
necessary remove the old label first. 


Store them in a suitable container in a safe 
place. 


Label diskettes clearly with what is recorded on 
them, including the name of the owner (if it is 
important) and the date it was recorded. 


Store diskettes in their protective envelopes. 


Take care when inserting diskettes into the 
diskette-drive. Slide them in without catching 
or bending them. 


Store at a temperature between 50 degrees and 
125 degrees Farenheit (10-52° Centigrade). 


Touch the inner diskette surface (the outer 
diskette cover can be touched). 


Keep diskettes near magnetic fields, radiators, 
heating or cooling ducts, or in direct sunlight. 


Place diskettes on top of your monitor. 


Let the diskette label adhesive near the exposed 
inner diskette. 


Bend or fold diskettes. 


Punch holes in the diskette using staplers or 
paper clips. 


Clean diskettes. 
Expose the inner diskette. 
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Write-protecting diskettes 


Diskettes can be physically write-protected to prevent anyone 
copying information onto them, or in any way changing their 
contents. 


On 514" diskettes, there is a notch in the top right-hand side of 
the diskette. To write-protect the diskette, you place a 
write-protect tab (usually supplied with your diskettes) over 
this notch. If the tab is removed, the diskette is no longer 
protected. Write-protecting diskettes is a good way of ensuring 
that people realize a diskette has important contents. 


Write protect notch 


FRONT BACK 


Some 51/4" diskettes do not have the write-protect notch and 
these are permanently write-protected. Usually application 
diskettes come in this format to prevent you from erasing their 
contents. 
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With 314" diskettes, the write-protect notch is in the same place 
as a 51%" diskette but the tab is built into the diskette. You slide 
the plastic tab up to protect the diskette; when you do this you 
can see a hole through the notch. 


Write protect notch 


se 


FRONT BACK 


Memory disks 


There is a third type of disk, the memory disk (sometimes 
called a RAM disk or Virtual disk). It is not a physical disk but 
is part of the computer’s memory that DR DOS treats as a very 
fast disk. Files can be copied to or from a memory disk, and 
programs run from it. A very important difference between a 
memory disk and a physical disk, is that when you switch off or 
reset your computer anything stored in the memory disk is lost. 
It is purely used as a temporary means of storage. For 
permanent storage you must always use a hard disk or 
diskettes. Memory disks are not usually configured as 
standard, read more about setting up and using a memory disk 
in Chapter 9. 
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Drives 


Disk reading devices on a computer are referred to as drives. 
The various drives within your computer are designated by 
letters followed by a colon. The first diskette drive is usually 
the A: drive, and a second diskette drive the B: drive. The main 
hard disk is usually referred to as the C: drive. Amemory disk 
would be given the first available letter after the physical 
drives, for example D: or E:. 


Files and directories 


Information which is to be held on a permanent basis on your 
computer is stored on disks, and is organized into files. A file 
can be composed of an application program, text like a letter or 
report, or computer data. A lot of your work within DR DOS 
will involve files. 


Files always have names to identify them (up to eight 
characters in length), and the filename can have an optional 
extension of up to three characters, separated from the 
filename by a period (.), for example: 


letter. txt 


The filename extension helps to identify the class of file, for 
example .txt means the file is a text file. 


DR DOS organizes files by storing them in directories. 
Directories contain certain information on the files they have 
stored in them, including their size, time of creation, and when 
they were last changed. Directories can also contain other 
directories with files in. Files and directories are further 
explained in Chapter 3. 


DR DOS: the operating system 


DR DOS links all the different parts of your computer together 
and makes them work as a complete system. It is the link 
between your computer hardware and software. (Hardware 
means the physical parts of your computer like the screen and 
keyboard, and software is the programs and applications you 
run on your computer.) 
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DR DOS creates the environment in which you interact with 
the computer, and within which your programs work. The 
operating system is a whole series of programs stored in the 
most part on disk, but called into the computer’s memory when 
required. DR DOS runs in the background basically “operating” 
your computer, hence the name Disk Operating System (or 
DOS for short). 


You work directly with DR DOS in many ways. You use it to 
run programs like a word processor, spreadsheet, or business 
application. You work directly with DR DOS to organize the 
information you create in your applications into files and those 
files into directories for ease of access. You use DR DOS to 
manage your information, for example removing files and 
directories you no longer need. You also use DR DOS to 
customize your system, for example to make your programs run 
faster and more efficiently. 


There are many things you can do with DR DOS. As your 
knowledge develops, you will find more and more applications 
of, and features within, DR DOS to enhance your work. 


1.2 Different disk configurations 


Your personal computer is likely to have one of three basic disk 
configurations: 


QO Ahard disk system with a single diskette drive 
Ol Atwin-diskette system 
(1 A hard disk system with two diskette drives 


With the twin-diskette system, you keep your DR DOS diskette 
in one drive and perform most of your operations on a diskette 
with your own data on it, in the other drive. With the hard disk 
systems most of your work will be performed on the hard disk. 
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1.3 Preparing disks for use 


WARNING 


All physical disks (hard disks and diskettes) need to be 
prepared using DR DOS before you can work with them. This 
process is called formatting and involves structuring the disk 
electronically into sections so that DR DOS can store and 
retrieve files more easily. 


The formatting process erases everything stored on a disk, 
whether it is a hard disk or diskette, so great care must be 
taken when using it. 


Preparing a hard disk 


When you install DR DOS, the INSTALL program detects 
whether your hard disk needs preparing. You should only need 
to prepare a hard disk once. In most cases your dealer will have 
already done this for you. Remember you should only prepare 
your hard disk when it is new and blank or if you want to erase 
everything from it and start again. You prepare a hard disk 
using the utility FDISK which is described in Chapter 8. 


Preparing diskettes 


New, blank diskettes need to be prepared using DR DOS before 
you can store information on them. To prepare a diskette, you 
can use the DR DOS command FORMAT. This command is 
explained in Chapter 8. Be sure your diskettes are not 
write-protected, see section 1.1. 
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1.4 How to install DR DOS 


Introduction 


Installing DR DOS is straightforward. When the INSTALL 
program is run, you work through a series of screens which give 
clear instructions on what you should do. 


Getting online help 


The INSTALL program provides context-sensitive help. To get 
help, move to the field on the screen for which you want help 
and press the F1 key. 


Cancelling installation 


You can quit the INSTALL program and discard any changes 
made by pressing the F10 key. You will see a screen asking you 
if you really want to leave the program, select the EXIT TO DR 
DOS option then press the Enter key. 


Reconfiguring your system later on 


Once you have installed DR DOS you can go back at any time 
and change the way your system is configured by running the 
DR DOS SETUP program, for example if you wanted to set up 
a memory disk. See Chapter 9. 


Starting the INSTALL program 


You can either install onto your first hard disk partition 
(normally C:) or onto diskettes. 


Insert the diskette labeled Startup into diskette-drive A: 
and close the door. 


Switch on the computer, or ifis it already on, press the 
Ctrl+Alt+Del keys at the same time (this is called 
“rebooting” your computer). 


Wait for DR DOS to display the first screen of the 
INSTALL program, the Welcome screen. 
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Follow the instructions shown. They explain which keys 
you can use to move between the various screens and fields 
and what each key does. The keys you use to move through 
the INSTALL program vary. The bottom line of each screen 
lists all the keys that pertain to this screen. The bottom 
line is updated as you move from field to field, or between 
screens. 


Where to install 


The next screen asks you where you want to install DR 
DOS, on your hard disk or on a diskette. 


Preparing a hard disk 


The INSTALL program detects whether your hard disk 
has been prepared for you. If it has not been prepared, you 
need to prepare your hard disk using a program called 
FDISK which INSTALL automatically starts for you at 
this point. 


WARNING FDISK should be used with care when prepaing a hard 
disk. It is normally only used to prepare new disks. 


For detailed instructions on how to use FDISK, refer to 
Chapter 8. When FDISK has finished, you are prompted to 
reboot your computer by pressing Ctrl+Alt+Del (ensure 
your Startup diskette is in diskette-drive A:), and start 
again from step 3. 


[ 6] Selecting configuration size 


If your hard disk already contains configuration 
information from a previous installation of DR DOS, you 
will be asked if you want the INSTALL program to use this 
configuration information instead of its own defaults 
(where applicable). 


If you choose to have your previous configuration files 
ignored, or you have not installed DR DOS before, you are 
presented with a screen which asks you to select the 
default size of your configuration. 


There are three options in this screen. You can choose 
between increased application memory at the expense of 
operating system performance, a balance between 
application memory and operating system performance, or 
increased operating system performance and functionality 
at the expense of application memory. 
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If you are not sure what to choose, select the middle option 
as it provides the best balance between system 
performance and application memory space. 


Selecting country, keyboard and keyboard type 


In this screen the INSTALL program asks you to define 
the country you live in and the national keyboard you wish 
to use. You are prompted as to whether you want to accept 
the default installation values or modify them. 


Note 


At this point, if your supplier of DR DOS has opted to 
include ViewMAX, you will be asked what mouse and 
display you want to use. 


Replacing existing files 
If you are installing onto a hard disk and updating to the 
new version of DR DOS, the INSTALL program gives you 
the option of replacing any existing DR DOS files. 


WARNING When you select the option to replace DR DOS files, all files 
on your hard disk in all subdirectories that have the same 
name as DR DOS files are replaced. This will happen even 
if the files were created in a different operating system 
from DR DOS. 


[9] Select installation or SETUP 


At this screen you can either accept default installation 
values, as selected in step 6, and go straight to installing 
DR DOS, or run the SETUP program and modify the 
default values. 


Using SETUP 


In SETUP a series of screens are displayed for you to supply 
the new values. Each screen has at least one option, and may 
also have one or more fields which you can edit. To move 
between fields and options, use the Up and Down arrow keys 
or the Tab key. There is always an option to continue without 
changing the settings. 
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In the next two screens you are asked where you want DR DOS 
to be installed and you can change your default path and 
append statements, for more information on PATH and 
APPEND see Chapter 8. 


Moving within the SETUP screens 


Each option is identified by a box shape on the left or right of 
the text. You will see that one option on the screen is 
highlighted. This is the current option. To choose another 
option, use the arrow keys or the Tab key to move to it. When 
you move to the option, it is highlighted on the screen. Press 
Enter to select it and then move to the next screen. 


Fields you can edit are displayed in reverse video. You can get 
help information on a field at any time by pressing the F1 
function key. As you move to each field, you see a flashing 
cursor next to the current field. Also, the menu line at the 
bottom of the screen is updated to show which keys you can use 
to edit the field. 


For example, if you are in a field from which you can choose 
YES/NO or ON/OFF, press the Spacebar to switch between the 
values. If you are in a numeric field, you can change the 
number in the field using the numeric keypad. To discard 
changes you have made to a field, press the Esc key. 


When you have finished, press Enter to move to the next field, 
or to the continue option to move to the next screen. 


Retracing your steps 


You can go back over the screens (and modify anything you 
have changed) by pressing the Esc key until you reach the 
screen you want. 


Installing DR DOS 


When you have finished configuring your system (or if you 
accepted the default values at Screen 9), the next screen 
prompts you to start the installation process. Press Enter. You 
will be prompted to insert the remaining installation diskettes 
during the procedure. 
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DR DOS starts to copy over various files to your disk: 


I Two special system files which contain the main operating 
system are copied to your root directory. If files of the same 
name already exist, DR DOS overwrites them. 


4 The file COMMAND.COM is copied to your root directory. 


QO Two files, autoexec.bat and config.sys, are created in your 
root directory. These files contain configuration information 
that DR DOS needs to access every time it is started up. For 
more information, see Chapter 9. If you already have these 
files on your disk they are overwritten. 


1 All other DR DOS files are copied to a directory of your 
choice. If you do not specify a directory, one is created for 
you from the root directory called DRDOS. If DR DOS files 
already exist on the chosen directory, they will be 
overwritten. 


Note 


To learn about files and directories see Chapter 3. 


When installation is complete, the INSTALL program prompts 
you to restart your computer by pressing the Ctrl+Alt+Del 
keys at the same time. After your computer completes its 
startup tests, you will see the DR DOS prompt, for example: 


C> 


You can always go back any time in the future to alter any 
aspect of your computer’s configuration by using the SETUP 
program, see Chapter 9. 


1.5 Getting started at the command line 


Changing between drives 


When you begin working with DR DOS you start at the 
command line or DR DOS prompt. 


(1 If DR DOS is installed on a hard disk: 
Co 
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If DR DOS is installed on diskette: 
A> 


The DR DOS prompt is where you enter instructions for your 
computer. The first prompt you see is the current disk drive. 
When you enter an instruction, DR DOS always looks to the 
current disk drive first. If you want a command to be directed 
at a different drive, you change to it by typing the new drive 
letter plus a colon and pressing Enter, for example: 


C> A: 


changes the current drive (C:) to diskette drive A: 

A> 

Any instruction you type now is directed at the A: drive. For 
example: 

A> DIR 

gives a listing of all files and directories on a diskette inserted 
in drive A:. 

You can tell DR DOS to look at another drive without changing 


the current drive. To do this include the drive letter and colon 
when entering the command. So, with the example above you 


type: 
C> DIR a: 
When giving instructions to your computer, for example 


starting a program, you must always direct them at the drive 
where the program or information is stored. 


Entering instructions 


After you enter an instruction at the command line, you always 
press Enter to make DR DOS carry out the instruction. 


If you make a mistake when typing a command, you see a 
message like this: 


Command or filename not recognized 


It may be that you have merely mistyped the instruction or 
directed the command at the wrong drive. 
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If you make a typing error and you have not yet pressed Enter, 
you can correct it by pressing the Backspace key (<) which 
erases the command line one character at a time. You can then 
retype the command. DR DOS also has a powerful feature 
which stores previously-entered commands and lets you recall 
them by pressing the up and down arrow keys. You can then 
edit and re-issue them. You may have set this up at installation 
by setting the HISTORY value to ON. If it was not set up at 
installation, it is very easy to set it up using the SETUP 
program, see Chapter 9. 


This and other ways of editing the command line are explained 
in Chapter 8, section 8.2. 


Introducing commands 


DR DOS contains an extensive set of commands. Command 
names are up to eight characters in length and are usually 
followed by options which contain further information about 
them. 


One useful command which you can get to know now is DIR, 
which provides a DIRectory listing of files and directories. Try 
typing the letters DIR at the command prompt, and press 
Enter: 


DIR a 


You should see a listing of all the files and subdirectories on the 
root directory of your disk with their size in bytes (characters) 
and the date and time they were last modified, plus how much 
space is left on the disk, as on the next page. 
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A:Nodir 


Yolume in drive A does not have a label 
Directory of A:N\ 


TOOLS <DIR> 12-64-96 
WORDPRO <DIR> 12-84-96 
SPREAD <DIR> 12-64-98 
GRAPHICS <DIR> 12-84-96 
ACCOUNTS <DIR> 12-84-96 
SALES <DIR> 12-64-98 
CLIENTS <DIR> 12-64-96 
AUTOEXEC BAT 416 16-64-94 
CONFIG sys 347 16-@4-98 11: 
93 File(s) 2568 bytes free 


A:\> 


The root directory is the first directory on your disk, read 
Chapter 3 for more information on directories. You can add an 
option to the command, for example /W which shows the listing 
in a wide format, giving space for more files on the screen: 


DIR /w 


A:Nodir “w 


Volume in drive A does not have a label 
Directory of A:N 


A:NTOOLS : SHORDPRO :\SPREAD : NGRAPHICS : \ACCOUNTS 
A:\SALES :N\CLIENTS : AUTOEXEC BAT : CONFIG SYS 


9 File(s) 2566 bytes free 


A:N> 
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Notice that the sizes and modification times of the files are not 
displayed, but many more files can be listed on the screen. 


Another useful command is the TREE command. It is similar 
to DIR in that it displays a listing of directories, but it shows all 
the directories on a disk wherever you type it from. For 
example it could display as follows: 


A:\>tree “g 
files path 
: a:\N 
tools 
L_¥_progran 
ordpro 
Pread 
L—§_finance 
___jinvoice 
raphics 
-__info 
accounts 
ages 
invoices 
ales 
L—_foreign 
lients 
ersonal 
total files 138 total bytes 1,165,293 


i) 


—_> 


2 
1 
3 
13) 
3 
3 
5 
13 
1 
1 
8 
5 
6 
9 
1 
3 


eN 


A:N> 


For more information on the TREE command, see Chapter 3. 


Getting help on commands 


Certain commands called external commands have a special 
option /H. This option displays help text on the command when 
you enter it at the command line. 


For more information on commands, see Chapter 2. Chapter 8 
provides a detailed list of the DR DOS commands. 
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1.6 Copying your master diskettes 


Before going any further make a copy of your DR DOS master 
diskettes using the DISKCOPY command. The DISKCOPY 
command automatically formats a diskette for you if it is not 
already formatted. 


WARNING DISKCOPY erases any information already stored on the 
diskette you are copying to. Make sure you use a blank 
diskette or one whose contents is not important to you. You 
need to know your drive and diskette types before you copy 
diskettes. You cannot copy from one type of physical drive 
to another, for example from a 31%" to a 514" drive, or 
between different density drives, for example from a 
1.2 Mbyte drive to a 360 Kbyte drive. 


To copy your master diskettes: 


From the DR DOS prompt type: 
DISKCOPY a: a: 


You are prompted to insert your source diskette. Insert the 
diskette labeled Startup into diskette-drive A:. This is your 
source diskette - the diskette you want to copy from. Press 
any key to start copying. 


A message appears tracking the copying process. You are 
prompted to insert your destination diskette. Remove the 
Startup diskette and insert a blank diskette to copy to. 
Press any key to continue. 


Follow the instructions as they advise you, to insert the 
source or destination diskettes in turn. Use the same 
source and destination diskettes until the DISKCOPY 
process is completed. 


When the copying is complete, you are asked: 
Copy another diskette (Y/N)? 


Remove the diskette already in the drive, press Y and 
insert diskette 2. Repeat the process until all the 
installation diskettes are copied. 
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Label your copied diskettes clearly, write-protect them, 
and store them and your master diskettes in a secure place. 


Twin diskette drive systems 
If you have a twin diskette system, insert a blank diskette into 
drive B: and type: 
DISKCOPY a: b: I 


Follow the instructions on the screen. 


1.7 Using other applications 


To start other programs and applications, like a word processor 
or spreadsheet, generally all you need to do is type the program 
name at the command prompt, and press the Enter key. For 
full details refer to your application’s documentation. 


Basic command 
concepts 


fj lpens chapter is an introduction to working with DR DOS commands. A 
command is simply a method of getting your computer to carry out a 
particular task like copying a file. Most commands act upon whole disks, or 
a specified file or group of files. 


The command line is the command followed by any other 
relevant information given at one time to the computer to 
enable it to carry out your instructions. The command line ends 
when you press the Enter key. DR DOS has a powerful feature 
which enables you to recall previously-entered commands; this 
is described in Chapter 8. 
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2.1 Command types 


Internal commands 


Certain DR DOS commands that are very useful, and therefore 
needed often, are stored in memory for quick access. They are 
loaded from a special file called command.com. This makes it 
easier for DR DOS to carry them out. These commands are 
called internal or resident commands (because they are kept in 
memory). Not many commands are stored in this way as it 
would take up too much space. These commands are available 
to you when you are working at the DR DOS prompt, C> or A>. 


You do not need to change to a particular drive or directory to 
use them. The internal commands are listed in Table 2-1. For a 
summary of what each command does, see the beginning of 


Chapter 8. 

Table 2-1 DR DOS internal commands 
ASSIGN DELQ PATH VERIFY 
BREAK DIR PROMPT VOL 
CHCP ERA RENAME/REN 
CHDIR/CD ERAQ RMDIR/RD 
CLS ERASE SET 
COPY EXIT SUBST 
CTTY HILOAD TIME 
DATE MKDIR/MD TYPE 
DEL MORE VER 


External commands 


Some commands that are used less often are not automatically 
loaded into memory. To save space they are stored on disk 
instead. These are external commands. They have the file 
extension .com or .exe. When you enter an external command, 
DR DOS retrieves the “command file” from disk and runs it. 
The memory used by the command is freed when it has finished 
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its job. BACKUP, RESTORE and DISKCOPY are examples of 
external commands, and will not work unless DR DOS has 
access to a directory containing the command files. 


DR DOS provides a command called PATH to make sure that 
external commands can always be found, even if they are stored 
somewhere other than the current directory. The PATH 
command is described in Chapter 3. The emernal. commands 


are listed in Table 2-2. 


Table 2-2 DR DOS external commands 


APPEND FASTOPEN NLSFUNC TREE 
ATTRIB FDISK PASSWORD XCOPY 
BACKUP FILELINK PRINT XDEL 
CACHE FIND RECOVER XDIR 
CHKDSK FORMAT REPLACE 
COMMAND GRAFTABL RESTORE 

COMP GRAPHICS SETUP 

CURSOR JOIN SHARE 

DISKCOMP KEYB SID 

DISKCOPY LABEL SORT 

EDITOR MEM SYS 

EXE2BIN MODE TOUCH 


Getting online help on external commands 


All external commands (except COMMAND.COM) followed by 
/H will display a help screen. 
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Batch processing subcommands 


Batch files are files in which you store a set of often-used 
commands. When you type the name of the batch file at the 
command line and press Enter, the commands are carried out 
as if you had typed them in one after the other. For example 
you can create a batch file which stores the commands you use 
to start an application like a spreadsheet. 


Batch files can be very powerful and DR DOS has a special set 
of subcommands for use in them. These subcommands are 
stored in the same way as internal commands, and are listed in 
Table 2-3. They are also described in more detail in Chapter 7. 


All batch processing subcommands are internal, and are listed 
in Table 2-3. 


Table 2-3 Batch processing subcommands 


@ ECHO IF REM 
‘LABEL FOR PAUSE 
CALL GOTO SHIFT 


Config.sys commands 


Apart from the commands we have already discussed, there is a 
special set of system configuration commands which are not 
entered at the keyboard, but are put into a file called 
config.sys. The config.sys file is looked at by DR DOS every 
time it is started. It then carries out any of the commands it 
finds there. These commands are set up for you automatically 
when you install DR DOS. For more information see Chapter 9. 
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2.2 Command syntax 


Command switches 


As mentioned in Chapter 1, DR DOS command names are up to 
eight characters in length and are usually followed by options 
(or parameters) that contain further information about the 
command, for example: 


CHKDSK /F 


Command parameters shown with a forward slash, for example 
/F, are referred to as switches. This is because they are used to 
tell DR DOS to switch to a particular variation on a command. 
/F tells CHKDSK to fix any errors detected. If you did not 
include the /F switch, errors would not be automatically fixed. 


Punctuation is usually needed to separate command names and 
their options. Generally you put a space between a command 
name and an option, and between options themselves. 


Sometimes other symbols must be used, for example commas or 
semi-colons; this is true of the MODE command: 


MODE COM1:9600,N,8,1 


Command specification 


The rules on how each particular command may be entered are 
listed in the command specification. In Chapter 8 under each 
command, the command specification explains exactly how it 
should be entered at the command line. For example, the 
syntax for CHKDSK, a useful command for getting a status 
report on the condition of a disk, is shown as: 


CHKDSK[/H] [d:] [/A] [/B] [/C] [/D] [/F] (/L] [/M] [/P] [/R] [/S] 
[/V] 


The square brackets mean they are optional. You can enter 
commands and their options in upper or lower case or a 
combination of both, it makes no difference. Commands only 
take effect after you press the Enter key. 


Acommand specification can be lengthy. You will find a 
complete explanation of them in Chapter 8. 
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Specifying drives 


Often, when entering a command, you need to state a source 
drive and a destination drive. The term drive refers to your 
hard disk and diskette drives, as well as to other removable 
storage disks and temporary memory disks created using the 
VDISK.SYS utility. You should have already encountered this 
in Chapter 1, when you copied your master diskettes. 
Remember DR DOS is a disk operating system, and commands 
need to be directed at the correct disk drive for DR DOS to be 
able to carry out the instruction. For example, with the 
BACKUP command (see Chapter 4) you specify where you are 
backing up from and to: 


BACKUP source_drive [filename] destination_drive 


The source drive can be your hard disk (for example C:) and the 
destination a diskette in drive A:. 


2.3 Displaying data a screenful at a time 


When a command displays a lot of information, it may move 
down a screen (scrolling), so you miss the first part of the 
display. This can happen if you enter a DIR command of the 
root directory, the listing may be so long it cannot all be shown 
on the screen at once. 


You can suspend ‘scrolling by pressing Pause or Ctrl+S. To 
start scrolling again press any key. Some commands have a 
switch /P for page which if specified as part of the command 
specification pauses at every full screen of information. 


2.4 Stopping commands 


You can stop commands when they are running by pressing 
Ctrl+C or Ctrl+Break. The processing of the command is 
stopped, and the command prompt returned. 


Managing your 
information 


S you work with your applications, you create your own information 

which needs to be organized for ease of access and security. You also 
need to learn how to manage your information, amongst other things to 
copy, delete, rename and print it. This chapter explains how you can 
achieve this with DR DOS using: 


O Files. 

C1! Directories. 

Q Directory tree structures. 

O Paths. 

OQ) Various commands which handle files and directories. 
| Wildcard characters. 
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3.1 Storing data in files 


Information on your computer is stored in files, and a lot of 
your work with DR DOS will involve them. A file is a collection 
of information that has something in common, for example it 
can be composed of an application program, text like a letter or 
memo, or computer data. Files always have a name to identify 
them (up to eight characters long) and filenames often have an 
extension (up to three characters long, preceded by a period), 
for example: 


myfile.doc 


Filename extensions are commonly used to indicate a category 
of files. Some extensions are automatically assigned by 
programs, for example Lotus 1-2-3 assigns the extension .wks. 
The filename extension should help you to identify what kind of 
a file itis. Some common filename extensions are explained in 
Table 3-1, you should not use these filename extensions for any 
other purposes. 


Table 3-1 Common f ilename extensions 


Extension Description 


$$$ Temporary or incorrectly closed file. Many 
programs write temporary files on the disk or 
diskette during their operation. 


-BAK Backup file created by a text editor. 

-BAS File containing a BASIC program. 

.BAT A file containing one or more commands that 
DR DOS executes sequentially. 

.COM DOS program file. 

.CPI Code Page Information file containing a specific 
national character set. 

EXE DOS program file. 


SYS Device drivers and the config file. 
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Naming files 


Your filenames can be any combination of A-Z and 0-9. The 
following special characters are reserved by DR DOS and must 
not be used in filenames: 


<>aiyj3:."? []0)/\+ 


Try to develop a logical system for naming your files, and make 
use of filename extensions. For example, you can identify all 
your correspondence by giving each file an extension like .let 
for “letter” or .doc for “document”. Naming related files in this 
way becomes particularly useful when you want to handle 
groups of files using wildcards, which are discussed later in 
this chapter. 


Filenames you should not use 


DR DOS uses special names to identify peripherals (devices 
added to your computer, for example a printer). These are 
called reserved device names. You should not call your files by 
these names; they are listed in Table 3-2. 


Table 3-2 Reserved device names 


Device name Explanation 


CON User console (the keyboard and the screen). 


AUX or COMn Serial communications port, where n is 1, 2, 8, 
4, depending on the particular computer. 


PRN or LPT1 First parallel printer LPT1. 


LPT2 Second parallel printer. 
LPT3 Third parallel printer. 
NUL All output to this device is discarded. No input 


is returned from the device. 
CLOCK$ Provides data and time support. 
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Handling groups of files (using wildcards) 


The ? wildcard 


The * wildcard 


To help you handle groups of files with ease and flexibility, 
there are two special characters, the asterisk (*) and question 
mark (?), known as wildcards. 


Wildcards provide a means of referring to more than one file at 
a time in a command specification. Using wildcards you can 
partly specify a filename so that several files could match it. 


The question mark wildcard matches with any letter in the 
exact position the question mark occupies. 


For example: 


COPY chapter?.doc a: 


matches with: 


chapterl.doc 
chapter2.doc 
chapter3.doc 
chapter4.doc 


So to copy all four chapters to a diskette, you only need the one 
command, COPY chapter?.doc a:. 

The asterisk wildcard is shorthand for several question mark 
wildcards. Where the question mark wildcard works from the 
one position, the asterisk wildcard works from one position to 
the end of the filename, or to the end of the file extension. You 
can have wildcards in both the filename and the extension. 


For example: 
chap*.* 
matches with all the chapter documents: 


chapterl.doc 
chapter2.doc 
chapter3.doc 
chapter4.doc 


However it also matches with other filenames like: 


chapmem. fax 
chaplist.doc 
chapfax.bat 
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Commands and wildcards 


WARNING 


The commands most often used with wildcards in their 
specification are COPY, DEL, (ERASE/ERAQ/DELQ), DIR, 
RENAME, and TREE. 


Wildcards are very powerful tools. They are extremely 
useful, but they can also be very destructive. For example 
* * means ail files. This is called the global wildcard. So if 
you type DEL *.* it erases ALL files in the directory in 
which it was carried out. When deleting files using *.*, you 
are always prompted before DR DOS carries out the 
operation, but you should still take great care when using 
the global wildcard. If you want to be prompted before 
deleting any file, use the ERAQ or DELQ commands. 


Examples of using wildcards 


If you had a diskette with six files: 


b.let 
b.pic 
a.let 
aa.let 
a.pic 
aaa.let 


and you want to delete the .let files only using the ERASE 
command, type: 


C>ERASE * let 


This erases all files with the extension .let. 


If you want to erase a.let and b.let, type: 
C>ERASE ?. let 

This erases the a.let and b.let files, whereas: 
C>ERASE ?.* 


erases a.let, b.let, a.pic and b.pic. 
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3.2 Using directories to organize your files 


The root directory 


Subdirectories 


The more files you create, the harder it is to keep track of them. 
You will find you need to organize them into groups according 
to their content, by project names, user names or classes. You 
can do this by using directories to order your files. 


When you format a disk or diskette and start storing files on it, 
a directory is automatically created called the root directory. 
The root directory can only contain a certain number of files, 
depending on the type of disk and diskette drives your 
computer has, so from the point of view of space on your hard 
disk as well as order, directories are very convenient. (Often 
with diskettes, all the files are stored in the root directory.) 


Directories created from the root directory are called 
subdirectories. Subdirectories can also contain further 
subdirectories. As you add more directories to the structure it 
will begin to grow into an inverted tree, that is the root at the 
top and the branches growing downwards. This is also called a 
multi-level directory structure: 


SUB DIRECTORY 
1 


SUB DIRECTORY 
2 


SUB DIRECTORY 
3 


SUB DIRECTORY 
OF 4 


| SE 
SUB DIRECTORY SUB DIRECTORY 
OF 2 OF 3 
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In the following tree, four subdirectories were made from the 
root directory: accounts, sales, clients, and wordpro: 


(.ccmppuitizmneanimmaee i esawesenncemeanasa ll | = RE EE 
ACCOUNTS CLIENTS WORDPRO 


INVOICES 


FOREIGN PERSONAL 


In the subdirectory accounts, two more subdirectories were 
created called invoices and wages. The sales and clients 
subdirectories also have subdirectories, foreign and personal. 


Files can be created anywhere in the structure. You can create 
many levels, but it would not be practical to make too many, as 
it would then become difficult to locate your files. 


Naming directories Naming directories follows the same conventions as naming 
files: a one-to-eight character name plus an optional extension 
of up to three characters. Normally you would want to keep 
directory names short. 
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The current directory 


Parent directories 


DR DOS considers the directory that you are working in at any 
one time as the current directory. When you carry out a task 
like creating a file, DR DOS assumes you mean it should be 
created in the current directory (that is the directory in which 
you are currently working), unless you specify otherwise. 


You can travel around the directory structure from the root 
downwards, or from anywhere within the structure back up to 
the root. You can also go straight to a directory without going 
through intervening directories. You move between directories 
using the CHDIR (change directory) command, see section 3.4. 
Each time you change directories using CHDIR, the destination 
directory becomes the new current directory. 


All directories (except the root) are contained within other 
directories. A directory which contains a subdirectory is known 
as the parent of the subdirectory. DR DOS uses special symbols 
to indicate the current directory and the parent of (or directory 
above) the current directory: 


Means the name of the current directory. 
Means the directory above the current one. 


These entries are automatically created by DR DOS when you 
make a directory. When you issue a DIR command, the entries . 
and .. appear at the top of the listing. 


If you type the command: 
dir .. 


you get a directory listing of the files in the parent directory of 
your current directory, see the next page. 
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Examples 


If accounts was the current directory, and you typed dir .., you 
would see a directory listing of the root directory. Remember 
the diagram: 


ROOT 


Parent of 
CURRENT 


Accounts 
CURRENT 


Note 


You cannot delete the . and .. entries. 


There are four commands that relate specifically to handling 
directories: TREE, MKDIR, CHDIR, and RMDIR. These 
commands are explained in section 3.4. Note that a complete 
description of them can be found in Chapter 8. 


The route to a particular directory is called a path, read section 
3.3 to learn about using paths to find your way around your 
directories. 
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3.3 Understanding paths 


Within a tree directory structure, it is quite acceptable for more 
than one file or directory to have the same name. For example, 
there may be a file called france.doc in the directory \sales 
and in the directory \accounts. We need a way of referring to 
files and directories which allows them to be specified uniquely, 
so we are able to access each of the two france.doc files in the 
above example without confusion. 


DR DOS provides such a mechanism. Every time you want to 
access a file or directory you specify a path to it. A path is like a 
roadmap, it tells the operating system the route to follow to get 
to a particular file or directory. 


You specify a path with a series of directory names, separated 
by backslashes (\). This traces a route through the tree 
structure to the desired point. 


If the first directory in the path is preceded by a backslash, 
then the path begins at the root directory. Paths which begin 
with a directory name, are taken as starting from the current 
directory. 


For example: 


c:\sales 


In this path, the search is to start on the C: drive. 


In the following path, sales and foreign indicate the names of 
the directories DR DOS has to pass through to locate the file 
france.doc: 


c:\sales\foreign\france.doc 


When you add a filename to a path it becomes a file 
specification (or filespec), in other words a way of specifying 
where a particular file is. See Chapter 8, section 8.1 for more 
information on defining a file specification. 


The path in a file specification can contain any number of 
directories, and can be anything up to 68 characters in length. 
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The PATH command 


In Chapter 2 we talked about external commands, the 
commands which are stored on disk rather than in memory. 
They include all files with extensions .exe and .com. DR DOS 
needs to be told where these external commands are. You tell 
DR DOS how to locate them using the PATH command. The 
PATH command can be used to specify a series of paths that DR 
DOS should search to find command program files. 


For example: 

PATH=C: \DRDOS; C: \PROGRAM; 

With this command you are telling DR DOS to first look in the 
subdirectory e:\drdos and if this proves unsuccessful, to look 


in the subdirectory c:\program. Notice that the individual 
paths are separated by semi-colons (;). 


Usually you would keep your most-often used directories at the 
beginning of the path for speed of access. 


Looking for external It is good practice to keep your external commands in one 
commands directory. This is done automatically for you during installation; 


the external commands are placed in the directory \drdos. 
Therefore it is useful for you to have the directory \drdos at 
the beginning of the PATH: 


PATH=C:\DRDOS 


Once a path is set up, you can type commands without having 
to worry about being in the wrong directory. The path remains 
set up until you restart your computer or issue another PATH 
command. 


You can always display the current path by typing: 
C>PATH 

You can clear the path by typing: 

C>PATH ; 


As well as external commands you also set the PATH to search 
for batch files (see Chapter 7). 
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Looking on different 


disks 


Using paths you can make DR DOS search on different disks or 
diskettes for files or programs. This is useful if you have a twin 
diskette drive system and no hard disk. You may have a 
program diskette in each drive, and you want DR DOS to 
switch between them to search for different program files. You 
can set up a path like this: 


PATH=A:\;B:\; 


DR DOS knows to look first in the root directory of the A: drive, 
and if the program is not there, to switch to the B: drive. 


Note 


Always specify the complete path including the drive for all the 
subdirectories in the path. 


PATH and the autoexec.bat file 


The best time to issue the PATH command is when DR DOS 
starts up. A file called autoexec.bat, which is always loaded as 
part of system startup, can help you do this. You can use the 
SETUP program to set (or modify) your path, see Chapter 9. 


Note 


Another command that works in a similar way to the PATH 
command is APPEND. Instead of external commands, it works 
with data files. See the explanation for APPEND in Chapter 8. 
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3.4 Working with directories 


Listing directories (the TREE commana) 


The TREE command allows you to list all the directories on a 
given drive and keep a track of your “tree” structure, for 
example: 


A>TREE C: 
gives you a listing of the directories on the C: drive. 


The list gives the space used and the number of files belonging 
to each directory, as well as the path to each directory like this: 


path 

iN 

:\Ntools 
:\tools\progran 
:\wordpro 

:\spread 

:\spread\f inance 
iNspread\f inanceS invoice 
:Ngraphics 
:\graphics\ info 
:Naccounts 

: Naccounts\wages 
:Naccounts\ invoices 
:Nsales 
iNsales\foreign 
:Nclients 
:\clients\personal 
total files 138 total bytes 1,165,293 


N 
Suen 


eal 


—_> 


a 
a 
a 
a 
a 
a 
a 
a 
a 
a 
a 
a 
a 
a 
a 
a 


Ge oOomnu oe coud u 


mM 


ArN> 


The TREE command has some useful parameters such as /F, 
which lists all the files in each directory, as well as the 
directories themselves. You can also produce a graphical 
display by specifying the switch /G, which generates a display 
similar to the one on the next page. 


Making 
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A:s>tree “g 
bytes 

737 

3,466 


files path 
2 a:\ 
tools 
L—_progran 
ordpro 
pread 
L—§finance 
L—invoice 
raphics 
L—jinfo 
accounts 
[wore 
invoices 
ales 
—_foreign 
lients 
ersonal 
total bytes 1,165,293 


ad N 
Counc on Ue 


Be 


i 
1 
8 
3 
6 
9g 
1 
3 


eh 


total files 138 


Aa:\> 


Note 


Acommand which lists the contents of directories and the 
subdirectories of those directories is the XDIR command, or 
Extended Directory command, see Chapter 8. 


a directory (the MKDIR command) 


To create a directory, use the MKDIR command (which can be 
abbreviated to MD). To create the directory accounts as shown 
in the example, type: 


C>MKDIR \accounts 
To make a directory below accounts, type: 
C>MKDIR \accounts\invoices 


or you can create a directory from the accounts directory itself. 


The directories, accounts and invoices, are now ready to 
receive files, and to be made the current directory. You can now 
create files with a word processor to store in these directories. 
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Note 
The. and .. entries in a directory are automatically created by 
DR DOS. DR DOS uses these symbols to indicate the current 


directory, and the parent of the current directory; see section 
3.2. 


Hs laying and changing directories 
splay Diy Ne ana g 


To change between directories in DR DOS type CHDIR (or CD 
for short) followed by a path. The directory you change to 
becomes your current directory. 


When you start your computer, the root directory is 
automatically the current directory. To make another directory 
the current directory type: 


C>CHDIR accounts 
To return to the root directory type: 
C>CHDIR \ 


(remember that the backslash represents the root directory). 
Also useful is the .. symbol. When you type: 


C>CHDIR.. 


you are moved up one level, for example to go back from the 
accounts directory to the root directory. 


Note 


If you type CHDIR without a path, you can find out the name of 
the directory you are in. 
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Removing a directory (the RMDIR command) 


The RMDIR (or RD) removes an empty directory. The form of 
the command is identical to that of MKDIR and CHDIR. 


For example to remove the subdirectory \accounts\invoices, 
where the current directory is \accounts, type: 

C>RMDIR invoices 

To remove the same directory when the current directory is the 
root, type: 

C>RMDIR \accounts\invoices 


Note the following about the RMDIR command: 


1 The directory to be deleted must be empty of files. The DIR 
command displays only the entries . and .. when a directory 
is empty. If DIR lists any more entries, the directory is not 
empty. 

1 The directory to be deleted must not have any subdirectories 
below it. Remove them first. 


OQ You cannot delete a directory while it is the current directory. 
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3.5 General actions on files 


This section lists other useful commands you can use with files. 
Note these are overviews and you should go on to read Chapter 
8 for a more detailed description. 


Copying files (he COPY command) 


Acommand that you will need to use often is COPY. Using it 
you can copy one or more files between disks (for example from 
a hard disk to a diskette), from file to file or between directories. 


For example: 


C>COPY wages.txt a: 


When you copy from disk to disk, you can use the same name 
for a file. 


However you cannot do this on the same disk, unless the file is 
in a different directory. For example you could type: 


C>COPY report.doc c:\sales\report.doc 


Note 


The XCOPY command is another useful command for copying. 
It can copy groups of files including a whole tree structure of 
files (for example files and directories) and is faster than COPY. 
See Chapter 8. 


Deleting files (the delete commands) 


Eventually you will want to delete files from your disks or 
diskettes to keep them from becoming too cluttered. You can 
use one of the five delete commands to do this: DEL, ERASE, 
DELQ, ERAQ, or XDEL. Type the command followed by the 
filename you want to erase: 


C>DEL myfile.txt 
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Caution 


All the commands work in much the same way, except that 
DELQ and ERAQ always prompt you before deleting a file. 
XDEL enables you to delete files and subdirectories. 


Take care when using the delete commands, particularly if 
you use wildcard characters. If you want to use wildcard 
characters, its safer to use the ERAQ or DELQ commands. 


Displaying file contents (the TYPE command) 


You can display the contents of a text file on your screen using 
the TYPE command like this: 


C>TYPE myfile.txt 


This command works only with text files. If you try to display a 
program file using TYPE, you get a lot of unintelligible 
characters and symbols. 


If you are looking at a large file, to see a screenful at a time, 
use the /P (Pause or Page) parameter: 


C>TYPE myfile.txt /p 


Press any key to see the next screen of text. 


Renaming files (the RENAME command) 


Sometimes you need to change the name of a file or group of 
files. To rename a file enter the command RENAME (you can 
shorten it to REN), followed by the filename you want to 
change and then the name you want to change it to, for 
example: 


C>RENAME myfile.txt newfile.txt 


If the file you are renaming is not on the current drive, you 
need to state where it is: 


C>RENAME a:myfile.txt a:newfile.txt 


You can rename groups of files using the wildcard characters 
for example: 


C>REN *.bat *.old 
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Printing files (the PRINT command) 


If you have a printer connected to your computer, you can use 
the PRINT command to send a file to it: 


C>PRINT myfile.txt 
You are prompted for the name of the print device connected to 
your computer: 

List device? [PRN] 


The print device is the printer port the printer is connected to 
(a port is a socket in your computer which can be used to 
connect your computer to a printer or other device). 


Press Enter to accept the default print device (in this case the 
printer port called PRN), or enter another print device (for 
example LPT1, LPT2, or LPT3) and then press Enter. 


You can carry on working with DR DOS while your file is 
printing, although your work may be slowed down if you are 
printing a very large file. 
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3.6 Keeping track of where you are 


Using the PROMPT command you can keep track of where you 
are in your tree structure. PROMPT lets you change the default 
DR DOS prompt, for example C>, to show the directory you are 
in. Do this by typing: 


C>PROMPT $P$G 
The symbol $P says show the current directory and the symbol 


$G means show the greater-than sign (>). This is the usual way 
in which the prompt is set up on hard disks. 


If you enter this command and then change to a directory called 
sales from the root directory you would see: 


C:\SALES> 

If you changed again to a subdirectory of sales you would see: 
C:\SALES\FOREIGN> 

so you always know what directory you are in. 


You can put the PROMPT command into your autoexec.bat 
file, so that it is entered every time you start up your computer. 


Note 


This is just one of the many ways in which you can change your 
default prompt using the PROMPT command. See Chapter 8 
for more information. 


Protecting your 
information 


R DOS offers two distinct methods of protecting the information in 
your files. 


QO) You can protect your information by making copies of your 
files at regular intervals. Then, if a file is accidentally 
erased or becomes corrupt, you have a copy of the original to 
refer to. This is called taking a backup. 


1 You can also protect your information from other people 
reading or changing it, by applying passwords to the files. 


This chapter describes these two methods. 
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4.1 Making and using backup copies of disks 


It is extremely important that you take regular copies of your 
work to safeguard against loss of data. Make it a part of your 
working routine to take periodic backups of your files. Backups 
are copies of information taken from one disk and stored on 
another. 


DR DOS provides three commands for this purpose: 


() For the hard disk, the BACKUP and RESTORE commands. 
These two commands always work together. 


1 For diskettes, the DISKCOPY command. 


Backing up your hard disk 


Establish a backup 
routine 


The BACKUP command enables you to copy all or part of a 
hard disk onto one or more diskettes. The original copy remains 
on the hard disk. You can then use your backup copies if the 
original is lost or corrupted, by restoring them using the 
RESTORE command. Any files backed up using the BACKUP 
command can only be used after you have restored them using 
RESTORE. 


When backing up your hard disk, you should try to establish a 
routine. Usually a backup of the entire hard disk is taken once 
every month or few months. Backing up the whole hard disk 
can be a lengthy task and requires a large number of diskettes. 
In between backing up the entire hard disk, you can back up 
any modified files using the various BACKUP command 
switches. How often you need to back up modified files depends 
on your working routine. You may need to backup files daily, or 
you may find once a week is enough. 


Before you make any backups, keep in mind these important 

points: 

“1 Do not backup disks affected by an ASSIGN, JOIN or 
SUBST command as they affect the way a disk is viewed by 
the system; always cancel these commands first. See 
Chapter 8. 


Q If your files and subdirectories have passwords, you need to 
give them first before taking a backup, see section 4.3. 
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(1 When you backup files onto a diskette, any files already on 
the diskette are overwritten, even if the diskette is not full. 
To avoid this happening there is a switch, /A, which tells 
DR DOS to preserve the files already on the backup 
diskette, see below. 


1 Make a note of the exact BACKUP command syntax you use 
to back up a disk, as you will need it when you restore your 
data, see the section Restoring BACKUP files. 


Backing up the entire hard disk 


Before backing up a hard disk you need to make sure you have 
plenty of new, blank diskettes to hand. To backup a full 

20 Mbyte hard disk you may need up to 60 formatted diskettes, 
though this number will vary according to the capacity of your 

diskette drive. 


To backup your hard disk onto diskettes type: 
C>BACKUP c: a:/s 


The /S switch tells BACKUP to back up all subdirectories as 
well as the root directory (if you did not specify /S, only the root 
directory would be backed up). 


You are asked to insert the first backup diskette into diskette 
drive A: 


Backing up from C:\ to A: 

Insert disk number 001 in drive A: 

All files in the root directory of the 
destination disk will be deleted 
Strike a key when ready 


The first diskette you insert is “backup diskette 001". Press any 
key to start the backup procedure. 


When the first diskette is full, you are prompted to insert the 
next diskette (002). Remove the first diskette and label it with 
its backup number (001), the date and the exact BACKUP 
command syntax you used. (It is important that you label your 
backup diskettes in the sequence they are created; this is due to 
the way in which the RESTORE command works. Also you will 
need to use the same syntax you used to backup your files to 
restore them.) 


Insert the next diskette, 002, and press any key to continue. 
When this diskette is full, remove it, label it, and then insert 
diskette 003. Continue doing this until the DR DOS system 
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prompt is returned. This may take some time depending upon 
the size of your hard disk. 


You now have a full set of backup diskettes for your hard disk. 
Now write-protect your backup diskettes using write-protect 
tabs (see Chapter 1, section 1.1). 


Backing up modified files 


To backup files changed since your last backup was taken, you 
use the switch /M (M means modified) as follows: 


C>BACKUP ec: a: /m 


If you intend to backup your modified files onto an existing 
backup diskette, you must specify the switch /A in the 
command line: 


C>BACKUP c: a: /m/a 


This is because backing up onto diskettes erases all the files 
that are already stored there. The /A switch tells BACKUP to 
preserve the files that already exist. You can also backup files 
modified since a specified date onto your backup diskettes 
using another switch, /D:date. For example: 


C>BACKUP ec: a: /d:8-3-90 


backs up all files changed since March 8th 1990. You can only 
separate the items in the date with hyphens. The date format 
you use depends on what country your system is set up for. 


Backing up directories 


To backup a specified directory and all its associated 
subdirectories, use the /S switch in the same way you used it to 
backup the root directory and all its associated directories. For 
example to back up the directory c:\accounts and all its 
subdirectories, type: 


C>BACKUP c:\accounts a: /s 


To back up a single file, specify the filename in the command 
line. For example: 


C>BACKUP c:\accounts\report.txt a: 
backs up the file report.txt onto a diskette in drive A:. 
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Using wildcard characters 


You can use wildcards in the command line. For example: 
C>BACKUP *.doc a: 


backs up all files in the current directory with the extension 
.doc onto a diskette in drive A:. 


Restoring BACKUP files 


The RESTORE command is always used to recover files stored 
using BACKUP. It works in a similar way to BACKUP. It copies 
backup files back into a usable form, usually onto the disk from 
which they originally came. If you labeled your diskettes 
correctly when you backed them up, you just insert them in the 
correct order. You need to use the equivalent syntax you used 
when backing up your files to retrieve them, so if you want to 
restore your complete hard disk backup type: 


C>RESTORE a: c: /s 


(The corresponding BACKUP command is BACKUP C: A:/S.) 


You are prompted to insert the first RESTORE diskette, which 
would be the first diskette you backed up onto: 


Insert disk number 001 in drive A: 
Strike a key when ready 


Press any key to continue. RESTORE displays the name of 
each file as it restores it to the disk. You are prompted as above 
until all the diskettes are restored, and then the DR DOS 
system prompt is returned. 

To restore the directory accounts and its associated directories 
type: 

C>RESTORE a:\accounts c: /s 


The RESTORE command has many switches which are similar 
to those of the BACKUP command. 


Checking what is on a BACKUP disk 


The RESTORE command has a helpful switch /R which reports 
on what files would be restored without taking any action. This 
is very useful for checking what files are on your backup 
diskettes. 
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More on BACKUP and RESTORE 


The BACKUP and RESTORE commands are far more powerful 
and flexible than outlined here. For more information see 
Chapter 8 which gives a listing of all the DR DOS commands 
their various switches, and their uses. 


Copying diskettes 


Caution 


The DISKCOPY command duplicates entire diskettes. We have 
already described DISKCOPY in Chapter 1. The basic format of 
the command for single diskette drive systems is: 


C>DISKCOPY a: a: 
For twin diskette systems type: 
C>DISKCOPY a: b: 


In either case, follow the screen prompts. DISKCOPY will 
automatically format your diskette for you if it is not already 
formatted. 


DISKCOPY overwrites anything that exists already on the 
destination diskette, that is, on the diskette you are copying 
to. If you wish to add files to a diskette without necessarily 
overwriting existing data, use the COPY or XCOPY 
commands. 


Always write-protect diskettes containing important 
information. 


For more information on this command, see Chapter 8. 
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4,2 Protecting files with the password 
command 


What is a password? 


A password is a set of characters you need to type in to gain 
access to information. In DR DOS you can apply three levels of 
password protection to a file: 


QO The highest level prevents anyone from even reading the file 
unless they issue the password. 


O The next level allows other users to read the file but not to 
change it without the password. 


The lowest level allows users to read and change the file, but 
not to rename or delete it without first giving the password. 


You can also password-protect directories. If you do this, all the 
files and directories within the protected directory are 
completely inaccessible without the correct password. 

You set passwords using the command PASSWORD. Passwords 
can be up to eight characters long. The PASSWORD command 
has the following format: 


PASSWORD filename switch:password 


PASSWORD switches The command has three switches which correspond to the 
levels of protection described above: 

/R The highest level. /R sets the password 
attributes R, W and D. You need the password 
to even read the file. 

/W The next level down. /W sets the password 
attributes W and D. You need the password to 
edit, copy, rename or delete the file. 

/D The lowest level. /D sets the password attribute 
D. You need the password to delete or rename 
the file or change the file’s attributes (for 
example read-only, see section 4.3). 


Note 


A full description of all the PASSWORD switches can be found 
in Chapter 8. 
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Setting passwords 


To set the password LUCKY with the highest level of protection 
to the file wages.txt, you type: 


C>PASSWORD wages.txt /r:lucky 
To set the password so that users can read and write to 


wages.txt, but not delete or rename it unless they issue the 
password, type: 


C>PASSWORD wages.txt /d:lucky 
Be careful when choosing a password. Make sure it is not too 


obvious to anyone attempting to work it out, or alternatively 
one that is too difficult to remember! 


Issuing Passwords 


To issue a password after you have allocated one to a file, you 
type a semi-colon immediately after the filename followed by 
the password. 


For example, the TYPE command is used to display a text file 
on the screen. To display the password-protected file 
wages.txt, you would type: 


C>TYPE wages.txt;lucky 


To copy the file wages.txt to a new file archives.txt on drive 
A:, enter the command: 


C>COPY wages.txt;lucky a:archives.txt 


Note that the copy, archives.txt is not password-protected. 
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Password protecting directories 


In the same way you give files passwords, you can also allocate 
them to directories using other PASSWORD switches. To assign 
a password to a path, you use the password switch /P:. For 
example to set a password on the directory 
e:\clients\personal type: 


C>PASSWORD c:\clients\ personal /p:private 


To access this path now you have to issue the password 
PRIVATE as follows: 


C>CD c:\clients\personal;private 


Global system passwords 


With PASSWORD you can also set a universal or “global” 
password, that is, a password that DR DOS automatically tries 
when you attempt to access a file or directory that is 
password-protected. 


This saves you having to give the same password every time 
you try to access one of the files in the group. 

This can be useful if you are working with an application that 
does not recognize passwords. 


After you have issued the global password it is tried against 
each password-protected file you try to access. The global 
password remains in effect until it is switched off explicitly by 
you, or until the computer is restarted. 


For example, if you had five files all protected with the 
password LEOPARD, to set the global password type: 
C>PASSWORD /G:leopard 


Now you would not have to issue the password LEOPARD for 
the files to which it applies. 


Note 


Remember to switch off the global password if you leave your 
computer unattended by entering the command 
PASSWORD /NG. 


58 DRDOS User Guide 


Removing passwords 
From a file To remove a password from a file, you type: 


C>PASSWORD filename /n 


For example to remove the password LUCKY from the file 
wages.txt, enter: 


C>PASSWORD wages.txt /n 


You are prompted to give the password: 
C:\Wages.txt ...file password? 


Type in the password LUCKY (it is not shown on the screen) 
and press Enter. The password is then deleted, you see the 
command prompt returned: 


C:\Wages.txt ...file password?***** 
--- ciwages.txt 
C> 


Alternatively, you can specify the password in the command 
line, for example: 


C>PASSWORD wages.txt;lucky /n 


From a directory To remove a password from a directory or path, type: 


C>PASSWORD dirpath;password /np 


For example to remove the password PRIVATE from the path 
c\clients\personal: 


C>PASSWORD c:\clients\personal;PRIVATE /np 


A note on password-protection 


The DR DOS password protection scheme is an easy and 
convenient way of preventing unauthorized access to data, or 
accidental loss of important information. However, you should 
not use this scheme as a substitute, only as an addition to 
physical security, that is keeping your computer and diskettes 
securely locked away if they have sensitive information stored 
on them. 
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4.3 File attributes and the ATTRIB command 


In addition to passwords, other pieces of information called 
attributes can be associated with a file. These attributes are 
described below. When you set an attribute it means it is active 
or switched on, when you reset it, it is non-active or switched off. 


A Archive bit. This attribute is set whenever a file 
is changed. It may be reset by, for example, 
BACKUP, FILELINK, REPLACE, XCOPY (and 
other commands), when a file has been 
“archived”, as well as by the ATTRIB command. 


H Hidden. Setting up the hidden attribute, makes 
the file invisible to the user, for example it will 
not appear in standard directory listings. 


R Read-only. When set, you can only read a file, 
you cannot write to it, or delete it. 

NS) System. Files with the system attribute set, are 
only displayed when the /S option is used with 
the DIR command. 


As stated above, the read-only attribute can be set to prevent a 
file or directory from being erased, renamed or copied. You 
switch it on using the ATTRIB command with the switch +r. 
This is described in Chapter 8. However, this method of 
protecting files is not as safe using passwords, as several 
commands have switches that allow you to alter read-only files. 


The safest way to protect a file or directory is to use the 
PASSWORD command. Setting a password with a/D level of 
protection is sufficient to stop another user from removing or 
changing an attribute, for example changing a read-only file to 
not read-only. 


The EDITOR 


ee chapter describes how to use EDITOR, a full-screen editor which 
you can use to create and edit text files. You can use it with any 
keyboard, and there are shorthand forms for some of the common 
commands. You can use EDITOR to: 

QO Create a new file. 

QO Browse through a file. 

QO Edit a file. 

For example you may want to create a batch file to start your 

favorite word processor. 
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9.1 Starting EDITOR 


There are two ways you can start EDITOR from the command 

prompt: 

Type EDITOR followed by the name of the file you want to 
edit or create and press Enter: 


EDITOR myfile.txt 


When you start EDITOR it looks for the file you specified 
(in the above example, myfile.txt) on the current drive, 
unless you specify a different drive or pathname before the 
name of the file. 

If EDITOR finds the file, it displays it on screen. If 
EDITOR cannot find the file it displays the message: 


iNnyfile.txt ...file not found 


reate new file (Y/N)? 


Type Y to create the file, or N to go to the EDITOR title 
screen where you can type in another filename, or press 
Esc to leave EDITOR. 


Type EDITOR and press Enter, this takes you directly to 
the EDITOR title screen: 


EDITOR R1.18 Full Screen Text Editor 
Copyright (c) 1988,1989 Digital Research Inc. All rights reserved. 


Please enter the nane of the text file you wish to edit. 
If the file does not already exist it will be created. 
Press the ESC key to leave this progran. 


File nane? 
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Type in a filename and press Enter, or press Esc to exit 
from the title screen back to the command prompt. 


9.2 Quitting EDITOR 


You can quit editing a file in three ways: 
To save your edited file and exit directly, press Ctrl+KX. 


G To save your edited file and return to the EDITOR title 
screen, press Ctrl+KD. 


<q] To abandon any changes made since the last time the file 
was saved and return to the EDITOR title screen, press 
Ctrl+KQ. 


EDITOR asks you if you really want to quit without 
saving your file, unless you have not made any 
changes. You are then returned to the EDITOR title 
screen, where you can press Esc to quit EDITOR. 
Ctrl+KQ is useful if you want to abandon a file that 
you opened by mistake. 


Note 

You can press Ctrl+R at the EDITOR title screen to display the 
previous filename edited, and press Enter to go back to editing 
that file. 


5.3 Entering text 


To enter text, type as you would if using a word processor or 
typewriter except when you reach the end of a line, press 
Enter to start a new one. This is because in EDITOR there is 
no “word wrap”; it does not automatically start a new line 
unless you tell it to. 
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Try entering this text, remember to press Enter at the end of 
each line. This takes you down to a new line: 


REM this batch file changes to the Wundawrd directory 
REM and starts my word processor 

cd \wundawrd 

ww 


This text creates a simple batch file used to start a word 
processor called Wundawrd. A batch file is a quick way of 
carrying out a series of frequently-used commands, you simply 
type the batch file name at the command line and all the 
commands in the file are carried out for you; see Chapter 7 for 
more information. (REM is a batch file subcommand which 
displays whatever you type after it on the screen, when the 
batch file is executed.) 


Notice as you type, at the top of the screen EDITOR keeps 
track of how many characters and columns you are entering: 


Chr=108 Col=3 


It tells you exactly which character and column the cursor is on. 
Also your directory path and filename are displayed at the top 
of the screen. 


Using the Tab key 


You can use the Tab key to move the cursor across the page and 
insert text at set points. The tab stops are preset to every 
eighth column across the screen. You can think of the Tab key 
as meaning “add space characters until you reach the next tab 
stop”. 


Moving text down a line 


If you press Ctrl+N when editing text, the rest of the line at 
the cursor is taken down to the next line, while the cursor 
remains where it is. For example, if the cursor was positioned 
after starts in this line: 


REM and starts my batch file 
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and you press Ctrl+N, my batch file would move to the next 
line, like this: 


REM and starts 
my batch file 


while the cursor is still positioned after "starts". 

Getting online help 
You can get help in EDITOR by pressing F1 or Ctrl+.J. To exit 
from the help screen, press Esc. You are asked: 


Do you wish to have the quick reference display (Y/N)? 


Type Y if you want the quick reference display. 


5.4 Moving the cursor 


You can move the cursor around your file in different sized 
steps from one character at a time up to the start or end of a 
file. 


To move the cursor one character 


QO To the right, > or Ctrl+D. 
Q To the left, < or Ctrl+S. 

Cl Up one line, T or Ctrl+E. 

G Down one line, J or Ctrl+X. 


Note 


On some keyboards the four keys D, S, E and X form an 
approximate diamond shape on your keyboard, sometimes 
called the “cursor-control diamond”. The position of these keys 
may help you to remember what they do. 
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To move the cursor one word 


O To the left, Ctrl+A. 
Q To the right, Ctrl+F. 
The keys A and F are also part of the “cursor-control diamond”. 


To move the cursor one page 


‘1 To the previous page, PgUp or Ctrl+R. 
1 To the next page, PgDn or Ctrl+C. 


A “page” is fourteen lines displayed on your screen. When you 
read through a file and you reach the bottom of the screen, 
pressing PgDn will display the next fourteen lines. Some of the 
previous page will still be displayed on the screen, to make it 
easier for you to find your place again. 


To move the cursor to the start or end of a line 


To the beginning of a line, press Ctrl+ QS. 
1) To the end of a line, press Ctrl+ QD. 


To move the cursor to the start or end of a file 


(1 To the beginning of a file, press Home or Ctrl+QR. 
To the end of a file, press End or Ctrl+QC. 
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To retrace our steps, here are all the cursor movement control 
keys. Again note the arrangement of command letters into the 
“cursor-control diamond” to help you remember these 


commands. 
Start of file 
Home or Ctrl+QR 
Previous line Previous page 
T or Ctrl+E PgUp or Ctrl+R 
Start of line Wordleft Char left Char right Wordright End of line 
Ctrl+QS Ctrl+A <¢orCtrl+S Ctrl+D or < Ctrl+F Ctrl+QD 
Next line Next page 
L or Ctrl+X PgDn or Ctrl+C 
End of file 
End or Ctrl+QC 
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9.9 Inserting and overwriting text 


EDITOR has two modes for entering text: insert (ins) and 
overwrite. When you start EDITOR, it is automatically in insert 
mode. The message ins is shown at the top rightmost corner of 
the screen. 


To insert text, position the cursor at the point where the new 
text is to start and type it in. The existing text, (or spaces) 
moves to the right to make room for what you type. 


You can switch to overwrite mode by pressing Ins or Ctrl+V. 
Now when you type you will overwrite whatever the cursor is 
positioned on. 


To switch overwrite mode off, press Ins or Ctrl+V again. 


Note 


Remember if ins is at the top of the screen, you are in insert 
mode. If ins is not displayed, you are in overwrite mode. 


Inserting a file at the cursor 


To read in a file, place the cursor where you want the file to be 
inserted, and press Ctrl+KR. You are prompted: 


Name of file to read in? 


Type in the name of the file you want to insert and press 
Enter. The file is inserted at the cursor. The remaining text is 
moved down to accommodate the new text. 


9.6 Deleting text 


Text can be deleted a character at a time, a word at a time or 
one line at a time. (You can also delete blocks of text, see 
section 5.7.) 
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Deleting a character 


To delete the character the cursor is on, press the Del key or 
Ctrl+G. 


The character is deleted from the screen, and the text 
to the right of the cursor shifts to the left to fill the gap. 


If you press Del or Ctrl+G repeatedly, characters will 
continue to be deleted until you reach the end of the 
file. 


To delete the character in front of the cursor, press the 
Backspace key or Ctrl+H. 


The character is deleted from the screen and the text 
to the right of the cursor shifts to the left to fill the gap. 


If you press Backspace or Ctrl+H repeatedly, 
characters continue to be deleted until you reach the 
beginning of the file. 


For example: 


If you typed Wundaief instead of Wundawrd. To delete “ief”, 
place the cursor on i and press the Del key until the letters i, e, 
and f, are deleted. The line containing the mistyped Wundawrd 
would change like this, with the cursor positioned at the end of 
the line: 


cd \Wunda 


Now you type in the correct characters, that is wrd. 


If you press Del at the end of a line, you delete the invisible 
“newline” character and bring up the next line. Similarly, 
pressing < (Backspace) or Ctrl+H at the beginning of a line 
moves that line up to the end of the previous line. 


Note 

If you want to delete more than one character, it is usually 
quicker to use one of the key combinations described in the 
following sections. 
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Deleting a word 


In EDITOR a “word” is defined as a string of characters that 
starts at the current cursor position and continues up to and 
including the first following space. 


QO) To delete a whole word, position the cursor at the beginning 
of the word to be deleted and press Ctrl+T. 


(! To delete part of a word, place the cursor within the word 
and press Ctrl+T. The letters at and beyond the cursor are 
deleted. The text to the right of the cursor shifts to the left 
to fill the gap. 


For example: 


If the cursor is positioned at the start of the word “changes” in 
the following line: 


REM this batch file changes to the Wundawrd directory 


pressing Ctrl+T repeatedly changes the appearance of the line 
like this: 

REM this batch file to the Wundawrd directory 

REM this batch file the Wundawrd directory 

REM this batch file Wundawrd directory 

REM this batch file directory 

REM this batch file 


Deleting a line 


Position the cursor anywhere in the line to be deleted and press 
Ctrl+Y. The line is deleted and lines below it move up to fill the 


gap. 
For example: 


If the cursor was positioned in the second line of the following 
text: 


REM this batch file changes to the Wundawrd directory 
REM and starts my word processor 

cd \wundawrd 

Ww 
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Pressing Ctrl+Y changes the appearance of the display like 
this: 
REM this batch file changes to the Wundawrd directory 


cd \wundawrd 
ww 


Pressing Ctrl+Y again produces this result: 


REM this batch file changes to the Wundawrd directory 
Www 


Pressing Ctrl+Y once more, produces this display: 
REM this batch file changes to the Wundawrd directory 


Note 

On some keyboards, the keys G, H, T and Y (for deleting 
characters, words and lines) are next to each other and form an 
approximate square. You may find this helps you to remember 
these commands. 


9.7 Working with blocks of text 


You can mark a section or block of text and then move, delete, 
copy it, or store it into a separate file. A block of text can be any 
size (according to how much disk space you have got). 


Marking a block of text 


To mark a block of text, place the cursor at the start of the 
section you want to mark and press Ctrl+KB. The text is 
marked with <B>. Move the cursor to the end of the block of 
text and press Ctrl+KK. The end of the text block is marked 
with <K>. 


Moving a block of marked text 


To move a block of marked text, place the cursor where you 
want the block to be moved to and press Ctrl+KV. The text is 
erased from its original position and moved to where the cursor 
is. The text moves up to fill the gap. 


72 DRDOS User Guide 


Deleting a block of marked text 


To delete a block of marked text, press Ctrl+KY. The text is 
deleted and the text beneath it moves up to fill the gap. 


Copying a block of marked text 


To copy a block of marked text, move the cursor to where you 
want the block of text copied to, press Ctrl+KC . The block of 
text is copied to the cursor position, still marked. The original 
text remains where it is and is no longer marked. 


Storing a block of marked text in a file 


To store a block of marked text in a separate file, press 
Ctrl+KW. You are prompted: 


Name of file to write to? 


Type in the name of the file where the text is to be stored and 
press Enter. The file is created and the block of marked text is 
written to it. If the file already exists, you are asked: 


File already exists, overwrite (Y/N)? 


Type Y to overwrite the file, N if you want to keep the file as it 
is. If you answer N no action is taken, press Ctrl+KW again 
and enter a different filename. 


5. 8 Saving your work 


You can save files in three ways: 
QO To save and exit from the EDITOR, press Ctrl+KX. 
O To save and continue editing your file, press Ctrl+KS. 


To save your work and begin editing a new file, press 
Ctrl+KD. 


This saves your work and updates your backup file, see section 
5.9. 
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5.9 Automatic backup files 


When you open an existing file, a “working copy” of the file is 
stored in memory. The original file remains on your disk, 
unaltered. 


When you save your edited file, the working copy is stored on 
the disk and is given the name of the original file. The old file 
becomes an EDITOR backup file with the extension .bak. 


For example: 


If you open the file mytext.doc and edit it, when you save the 
file the following happens: 


QO The original file mytext.doc is renamed to mytext.bak. 
1 The new version is stored with the name mytext.doc. 


You can use backup files to recover files. For example if the 
current version is: 


(1 found to be incorrect. 


Q accidentally erased. 


If you accidentally deleted the file mytext.doc, you could 
revert to the .bak file by typing: 


C>COPY mytext.bak mytext.doc 


Note 


To prevent any filename conflicts, EDITOR does not allow you 
to edit files with the extension .bak. 
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5.10 Technical details 


| 


oO 


Cl) 


a) 


EDITOR produces ASCII files with no embedded specific 
control characters, so its output can be used for batch and 
similar files. It allows 8-bit characters to be entered and 
displayed. 

There is no size limit on the files you can edit, apart from 
the size limit imposed by the amount of disk space you have 
available. 


The Enter key inserts two characters into the file being 
edited: a carriage return (ASCII code 13) and a line feed 
(ASCII code 10), in that order. Note that a single CR, a 
single LF or a CR/LF pair is always treated as a single 
character when moving through the text. 


The Tab key inserts a character (ASCII code 09) into the 
file. On screen the Tab character inserts spaces from the 
cursor position to the next tab stop. A tab stop is preset at 
every eighth column across the screen. 


EDITOR does not insert any special End-of-File marker, but 


will recognize the End-of-File marker code 26 (ASCII 
Ctrl+Z) used by some older style editors. 


EDITOR provides automatic creation of .bak backup files. It 
does not allow you to edit files with a .bak extension. 


During use, EDITOR creates two temporary files in the 
same directory as the file you are editing. These are 
automatically deleted when you quit EDITOR. 
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5.11 Command summary 


Table 5-1 Summary of EDITOR commands 


Keys Function 
Getting help 
F1 or Ctrl+J Displays help text 


Moving the cursor 


Home or Ctrl+QR Start of the file 
End or Ctrl+QC End of the file 
Ctrl+Qs Start of the line 
Ctrl+QD End of the line 
< or Ctrl+S Character left 
CtrlA Word left 

— or Ctrl+D Character right 
Ctrl+F Word right 

T or Ctrl+E Previous line 

L or Ctrl+X Next line 
PgUp or Ctrl+R Previous page 
PgDn or Ctrl+C Next page 
Deleting text 

Del or Ctrl+G Delete character 
Ctrl+Y Delete line 


Backspace or Ctrl+H Delete character to the left 
Ctrl+T Delete word to the right 
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Table 5-1 (continued) 


Keys Function 

Working with blocks of text 

Ctrl+KB Mark the start of a block of text 
Ctrl+KK Mark the end of a block of text 
Ctrl+KV Move a marked block of text 
Ctrl+KY Delete a marked block of text 
Ctrl+KC Copy a marked block of text 
Ctrl+KW Store a marked block of text in a file 
Saving files 

Ctrl+KX Save changes, exit 

Ctrl+KD Save changes, edit new file 
Ctrl+KS Save changes, resume 
Ctrl+KQ Abandon changes, edit new file 


Other commands 
Ins or Ctrl+V 


Ctrl+KR 
Enter or Ctrl+N 


Switch between insert and overwrite 
modes 


Read in a file at the cursor 


Insert a new line at the cursor 


Redirecting input and 
output 


ORMALLY you enter information at the keyboard, which is the 
standard input device and the information is sent to your screen which 
is the standard output device. In DR DOS you can redirect this flow of 
information and send it to a place other than your screen, for example to a 
file or printer. 
In this chapter we will talk a lot about input and output. Input 
is simply what you enter at the keyboard, for example a 
command, and output is the result of that command. 


78 DRDOS User Guide 


6.1 Using redirection 


Redirecting output 


Instead of your information being sent to the screen you can 
send it to a file or print device. To do this you use the 
redirection symbol “>”. 


For example, to redirect the listing that the DIR command 
produces directly to a file instead of displaying it on the screen, 


type: 

C>DIR >mylist.doc 

If the file mylist.doc did not exist, it would be created for you. 
If it does exist, the original will be overwritten, so take care. 


Instead of the filename, you can enter a file specification: 
C>DIR >a:\report\mylist.doc 


if the file you want to redirect output to is not on the current 
drive. 


You can also redirect the CHKDSK command’s disk status 
report to a file: 


C>CHKDSK a: >status 


Redirecting output to or from a device 


You can redirect output to a device which is a piece of 
equipment that receives computer data. Typical devices are 
printers, plotters and modems. 


As discussed in Chapter 3, devices are often named according to 
the communications port on the computer to which they are 
connected. Printers can be called “PRN” or “LPTn”, (where n 
could be 1, 2 or 3). Table 6-1 lists the device names and shows 
their use with redirection. 
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Table 6-1 Device names and their use with redirection 


Device What it is Use 


CON User console (the keyboard Input and Output 
and the screen). 


AUX orCOM1 First serialcommunications Input and Output 
port. 


COMn Second and subsequent serial Input and Output 
ports where n is 2, 3, 4, 
depending on the particular 


computer. 
PRN or LPT1 First parallel printer. Output 
LPT2 Second parallel printer. Output 
LPT3 Third parallel printer. Output 
NUL All output from this device Input and Output 


is discarded. No input is 
returned from the device. It 
is used to discard unwanted 
output. 


For details on how to set up a port for a particular device, refer 
to the MODE command in Chapter 8. The form of the command 
for redirecting to a device is: 


command >device 
For example, the command: 


C>DIR a: >prn 


sends the DIR listing of drive A: to the printer rather than to 
the screen. 
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Appending output 


You can append the output of a command to the end of a file, 
using the redirection symbol “>>”. For example to add a file 
index.dat to the end of an existing file book.txt, type: 


C>TYPE index.dat>>book.txt 


The file book.txt now contains the contents of both files. 


Redirecting input 


Sometimes it is useful to make the contents of a file the input 
for a command. You achieve this using the redirection symbol 
Pde 

For example, to make the input to the SORT command (which 
sorts the contents of a file into alphabetical order, see section 
6.2), a file called teleph.doc, type: 


C>SORT <teleph.doc 


SORT takes the file, sorts its contents alphabetically and 
outputs the result to the screen. 

Taking this a step further, to store the output of SORT into a 
file instead of just displaying it on screen, type: 

C>SORT <teleph.doc>telelist.doc 


SORT takes the teleph.doc file, sorts it into alphabetical order, 
and stores the result in the file telelist.doc. 


6.2 Using pipes and filters 


Pipes 


Sometimes you will find it convenient to use the output from 
one program as the input to another. For example, the DIR 
command often produces a listing so long it cannot all be shown 
on the screen. In this case you can connect the output of DIR to 
the input of the MORE command, which displays output one 
screenful at a time. You can make this happen using a pipe; the 
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piping symbol is "|" (a vertical bar). This is how the above 
example would be entered: 


DIR | MORE 


You can pipe as many commands as you like. Piping is often 
used with filter commands. 


Note 


When you pipe programs together, the data piped between 
them is stored by DR DOS in temporary files it creates on the 
default disk; there must be sufficient space on the disk for them 
and the disk should not be write-protected. (The temporary files 
are removed when the operation is complete.) 


Filter commands 


DR DOS has several commands which act as filters and can be 
"piped together”. A filter command reads your input, acts upon 
it in some way and then outputs the result, usually to the 
screen. The main filter commands are: 


SORT Arranges data into alphabetical order before 
displaying it on the screen. 


MORE Displays a file’s contents a screenful at a time. 
FIND Extracts specified items of data for display. 


For example, SORT is often used with the DIR command to sort 
the listing produced for example by filename or by size of file. 


Typing: 
C>DIR | SORT /R 


sorts the directory listing produced by DIR in reverse 
alphabetical order (the /R switch indicates it should be done 
from last to first instead of the default which is first to last). 


The following command sorts the file namelist.doc using 
SORT. SORT arranges the file contents into alphabetical order 
before it is displayed on the screen: 


C>SORT <namelist.doc 


So, if the file namelist.doc contained the following names: 


Henry 
Sally 
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James 
Sue 
Fred 


they are arranged into alphabetical order as follows: 


C>sort 


fred 
henry 
james 
sally 
sue 


C> 


The following command sorts the file tele.lst into alphabetical 
order, and displays the result a screenful at a time: 


C>SORT <tele.lst | MORE 


In the following command line DIR and FIND are piped 
together to search for (FIND) and list (DIR) a directory called 
drdos: 


C>DIR | FIND drdos 


C>find drdos 
DRDOS <DIR> 3-01-90 3:42p 


Note 
For more details on these commands, see Chapter 8. 


Combining pipes and redirection 


You can also use piping and redirection together. For example: 
C>DIR | SORT >dirsort 


produces a directory listing which is sorted into alphabetical 
order, and then stored in the file dirsort. 


Grouping commands 
in batch Tiles 


Li when you work with DR DOS you type in commands at the 
command line and DR DOS carries them out. This is interactive 


processing. 
processing. 


There is another kind of processing you can use called batch 


With batch processing you collect a series of commands 
together into a batch file. After you type the name of the batch 
file at the command line, each command in the file is executed 
in turn, just as if you had typed the commands one at a time. 
Batch files can have any eight character name, but they must 
always have the extension .bat. 
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7.1 Using batch processing 


As you work regularly with DR DOS you will probably find 
yourself typing the same command or sequence of commands 
over and over. For example, you may have a set procedure each 
morning to load your spreadsheet program, and another 
procedure in the evening to backup all the files you created or 
altered that day, or you might regularly print a group of files. 


In batch processing you can group all the commands you need 
to carry out these tasks into one file to save yourself the bother 
of typing them all in. For example, if you used the following 
commands to tidy your disk and backup your files at the end of 
each day: 


C>CD \letters 

C>ERASE *.old 

C>MD a:\dayswork 
C>COPY *.doc a:\dayswork 


you can create a batch file to contain all these commands called 
dayover.bat. Then at the end of each day, all you need type is: 


C>dayover 


DR DOS first carries out the command CD \letters (change to 
the subdirectory letters). It then returns to the batch file and 
carries out the command ERASE *.old (delete all files with the 
extension *.old). Next it processes the command MD 
a:\dayswork (make the subdirectory dayswork on drive A:). 
Finally it returns to the batch file to carry out the command 
COPY *.doc a:\dayswork (copy all files with the extension .doc 
to the subdirectory dayswork on a diskette in drive A:). 


Note that each new command in the batch file must start on a 
new line. 


Batch files are a flexible and powerful feature of DR DOS. You 
can create very simple to very complex batch files. They are 
useful for shortening commands, and for ensuring a procedure 
is carried out the exact same way every time. 
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7.2 Creating batch files 


You can create batch files with EDITOR, a word processor or 
with the COPY command (see Chapter 8). Below is an example 
of how to use EDITOR to create a simple batch file. (If you 
create the file with your favorite word processor, make sure the 
finished file is in plain text, that is ASCII format; refer to your 
word processor manual for details.) 


To create the example file dayover.bat: 
From the command prompt type: 
EDITOR dayover.bat 


as this is a new file you see a message similar to this: 


C:\Dayover.bat ....file not found 
Create new file (Y/N)? 


Answer Yes and the file is created; the EDITOR screen is 
displayed. 
Type the commands you want to enter in the batch file, 
pressing Enter at the end of each line: 
CD\letters 
ERASE *.old 
MD a:\dayswork 
COPY *.doc a:\dayswork 


Press Ctrl+KX to save the file and quit EDITOR. 


A similar procedure can be used to create any batch file. 


7.3 Running batch files 


Any batch file that you want to run must be located in either 
the current directory or one of the directories in the search path 
set up by the PATH command. (The PATH command is 
described in Chapter 8). 
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To run the batch file simply type the batch file’s filename. You 
do not need to type the .bat extension. To run the file 
dayover.bat, all you need type is: 


C>dayover 
DR DOS returns to the prompt when the batch file is finished. 


Stopping a batch file 


To stop a batch file while it is running, press Ctrl+C and you 
will see: 

Halt Batch Process (Y/N)? 
Type Y for yes and the remaining commands in the batch file 


are not carried out; you are returned to the DR DOS prompt. 
Type N for No and the remaining commands are processed. 


7.4 Making general purpose batch files 


DR DOS allows you to make general purpose batch files, that 
is, a batch file which can be made to do different things by 
adding parameters when it is run. 

Suppose you often move files from the subdirectory 
\amanda\letters to another subdirectory called 
\queries\donewith. You need a general-purpose batch file 
that will copy any file from the first subdirectory to the second, 
and then delete the original file. If the batch file is called 
moveover.bat, all you will want to type is: 


C>MOVEOVER filename 


where filename is the name of any file that you want to move. 
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The batch file needed to be run from c:\amanda\letters 
would be: 


COPY $1 c:\queries\donewith 
ERASE 31 


where %1 is a variable that is replaced by the filename when 
the batch file is run. Variables take the form %n, where n is a 
number from zero through nine. The variable %0 is always the 
name of the batch file (unless you use the SHIFT command), 
and its drive specification, if included. 


For example, if you typed the batch file command: 
C>MOVEOVER jones.let 

the commands actually carried out by DR DOS are: 
C>COPY jones.let c:\queries\donewith 

followed by: 

C>ERASE jones.let 

If you type the batch file command: 
C>MOVEOVER smith. let 

the commands actually carried out by DR DOS are: 
C>COPY smith.let c:\queries\donewith 


followed by: 
C>ERASE smith.let 


Remember these points when including variables in your 
general purpose batch files: 


1 You can specify up to 10 variables (%0 through %9) at any 
one time. If you need to use more than 10 variables, see the 
SHIFT command. 


Always separate variable values by a space, and make sure 
that values are entered in the proper sequence. 


Oo 


cl 


If you want to use % as a filename within a batch file, you 
must include it twice. For example, if the filename is 
test%.dat, the batch file must specify test%%.dat. It is 
generally not good practise to use the percentage sign in 
filenames. 


88 DRDOS User Guide 


Environment variables 


Batch files can also retrieve and use environment variables 
such as “OS” (defining the operating system), “VER” (the 
current version number), and “path” (the current path). See 
also the SET command in Chapter 8. 


The environment variable names must be surrounded by % 
signs when used in batch files. 


For example, including the following command in the 
autoexec.bat file: 


PROMPT %0S% $PSG 
changes your default prompt to: 
DRDOS C:\> 


7.5 Batch file subcommands 


Batch files can be made to be much more than a simple list of 
DR DOS commands and variables. Using batch file 
subcommands you can create batch files that will: 


Call a second batch file from within the first one. 


I Display (or not display) the batch file commands on the 
screen. 


a) 


Cause the batch file to pause while you change diskettes. 


“1 Display a message on the screen. 


Other batch file subcommands enable you to write batch files 
that are like simple programs. Such batch files can take 
decisions and process files in different ways depending on the 
type of file. 


Note 
Batch processing subcommands are all internal commands. 


Table 7-1 contains an alphabetical list of all the batch 
processing subcommands. 
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Table 7-1 Batch processing subcommands 


Command Explanation 


@ Prevents a command from being displayed. 

:LABEL Defines a label which can be referenced by a 
GOTO batch subcommand. 

CALL Calls a batch file from within a batch file. 

ECHO Allows or inhibits the display of command lines 
or displays “messages”. 

FOR Allows repetitive execution of a command for 
each file specified. 

GOTO Transfers control to the line following the label. 

IF Provides conditional execution of commands. 

PAUSE Stops batch file processing until the user 
presses any key. 

REM Allows comments to be inserted into a batch file. 

SHIFT Makes it possible to change the position of 


command line parameters to access more than 
10 (%0 through %9) replacement variables. 


Note 


These commands are laid out on the page in a similar way to 
the commands in Chapter 8. Please refer there for an 
explanation of page layout if one is required. 
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Command conventions 


The following conventions are used in the command 


descriptions: 


[] 


command 


filespec 


Square brackets indicate an optional part of the 
command line. Do not type the square brackets 
themselves, for example for [/C] you type /C. 


A vertical bar indicates an either/or choice, for 
example ON| OFF. Choose just one of the 
options, and do not type the vertical bar. 


Indicates DR DOS command. 


Represents the location of the file in the 
subdirectory structure. When you type a 
filespec, each directory should be separated 
from the next by a backslash (\), and the last 
directory separated from the filename by the 
same symbol, for example: 
c:\drdos\command.com 


Represents a number you type in. The values 
you can substitute are given in the command 
explanation. 
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@ 


Format 


@command 


Explanation 


If you place the @ symbol in front of a command, it will prevent 
it from being displayed when a batch file is executed. For 
example if you place @ in front of the command ECHO=OFF, 
ECHO=OFF will not be displayed. 
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‘LABEL 


Format 


: LABEL 


Explanation 


LABEL defines a label which can be referenced by a GOTO 
batch subcommand. Only the first eight characters after the 
colon are considered part of the label, additional characters are 
ignored. Labels are not displayed during batch file execution. 
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GALL 


Format 


CALL filespec 


Explanation 


CALL allows a batch file to load and run a second batch file, 
and then returns to execute the remaining commands in the 
original batch file; the PATH is searched when the second batch 
file is looked for. 


CALL subcommands can be placed at any line in the batch file. 


Example 


The following example calls the batch programs second.bat 
and third.bat and processes them in turn: 


CALL second 


CALL third 
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ECHO 


Format 


ECHO [ON|OFF|message] 


Explanation 


ECHO allows or inhibits the screen display of DOS commands 
executed from a batch file. It does not affect the messages 
produced during command execution. 


ECHO is ON by default, and shows all commands as they run. 
ECHO OFF stops all commands from appearing on the screen. 


The ECHO message option displays messages on the screen 
whether or not ECHO is ON or OFF. You can display several 
lines of text in this way: 


ECHO This is my very 


ECHO own batch file 


The current status of ECHO is displayed if ECHO is issued 
from the command line with no parameters. 


Note 


Preceding a command with the @ character prevents the 
command from being displayed. For example, if a batch file 
included the command @ECHO OFF, the words echo off would 
not be displayed on the screen when the batch file is run. 


@ECHO OFF is often used at the start of a batch file to prevent 
all commands from being displayed. 
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FOR 


Format 


FOR $%$variable IN (fileset) DO command 


Explanation 


FOR allows for repetitive execution of a command. Each 
filename in the set is sequentially substituted in the command 
following DO. Wildcards are valid for members of the set and 
all matching filenames on the disk are substituted in the 
command. Only one FOR command can be used on a command 
line. 


Example 


If you enter this command in a batch file: 


Ze 


FOR %%sf IN (myprog.asm acct.bas acct2.bas)DO type %% 


the three specified files are each typed to the screen in turn. If 
you enter a command like this at the command line, you only 
need enter one set of % signs, for example: 


FOR Sf IN (myprog.asm acct.bas acct2.bas)DO type %f 
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GOTO 


Format 


GOTO label 


Explanation 


The GOTO subcommand means processing of the batch file will 
continue from the line following on from the label specified. If 
the label is not found, the current batch file ends with this 
message: 


Label ... not found 


To set up a label in a batch file, use a colon (:) followed by a 
character string. The first eight characters of the string are 
considered the significant characters, and they must be 
different from those of all other labels. 


Labels within a batch file are not shown while the file is 
executing. Labels not referenced by a GOTO subcommand may 
be used to place comments in your batch file. 


Example 
The following batch file displays the file info.txt continously, 
until you press Ctrl+C or Ctrl+Break: 


<Scare 
TYPE info.txt 
GOTO start 
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IF 


Format 


IF [NOT] condition command 


Explanation 


IF allows conditional processing of DOS commands. The DR 
DOS statement is executed when the IF condition is true. When 
the condition is false, the DR DOS command is ignored and the 
next statement is executed. 


condition can be one of the following: 
4 ERRORLEVEL number 


This condition is true if the previous program had an exit code 
of greater than or equal to number. Your programs can set an 
error code that can then be checked by the IF ERRORLEVEL 
command. 

QO string1==string2 

When string1 and string2 are identical, this condition is true. 
1 EXIST filespec 


If filespec is on the indicated drive, EXIST filespec is true. 
Pathnames are allowed with the filespec. Note that an 
explanation of filespec can be found in Chapter 8, section 8.1. 
If you include the NOT parameter, DR DOS will carry out the 
command when the condition is false. 


Note 


Many DR DOS commands set the ERROR LEVEL which can be 
tested with an IF ERRORLEVEL command; see Chapter 8 for 
details. 
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Examples 
IF EXIST filespec command: 


if exist myfile goto xyz 
dir bs 


TXYZ 


command 


This condition is true if executed with myfile on the default 
drive. The command following the label XYZ is executed. If 
myfile is not found, the GOTO XYZ is not executed and 
processing continues with the DIR B: command. 


IF string1==string2 command: 


if “S$1"=="John" echo What are you doing here? 


The batch file with this command, assuming John is named as 
the %1 parameter, performs the ECHO batch command. “What 
are you doing here?” is displayed. If John is given as the %1 
parameter, the condition is false, and the ECHO batch 
command is not executed. 


Note 


You should always place quotation marks around the text 
string, as this prevents syntax errors if no parameters are 
specified. 


IF ERRORLEVEL number command: 


XCOPY $1 C:\queries\donewith 
if errorlevel 1 goto nodelete 
del $1 


:snodelete 


The above example further enhances the batch file 
dayover.bat (described in section 1.1) to only delete a file if the 
file is copied first. The XCOPY command is used to copy the 
file. When it completes, XCOPY sets the errorlevel to 0 if it 
finishes successfully, and to 1 if it fails. If it fails, the condition 
is true and the line “if errorlevel 1 goto nodelete” is processed. 
This ensures the file is not deleted unless it has been copied 
first. 
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IF NOT EXIST filespec command: 

if not exist a:%1 copy b:%1 a: 

myprogl 

This batch file is looking for a certain file to be on drive A:. The 
IF condition is executed before myprog]1 to ensure that the 
required file is on drive A:. If the file is not on drive A:, the 
condition is true and the copy command is processed, copying 


the file from drive B: to drive A:. If the file is on drive A:, the 
copy is not processed. 
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PAUSE 


Format 


PAUSE [remark] 


Explanation 


You can insert a PAUSE subcommand into a batch file to delay 
the processing of the file. The pause in processing allows you to 
let an action occur, such as changing disks. 


PAUSE always shows the following message: 
Strike a key when ready . 


The optional remark can contain a maximum of 122 characters. 


Example 


The following example shows a PAUSE subcommand in a batch 
file: 


COPY As*.* Bs 
PAUSE Insert new disk in drive A 
COBY Ai*.* Bes 


When storage.bat is run, the first diskette in drive A: is 
copied. Then the processing is suspended and this message 
appears: 


PAUSE Insert new disk in drive A 
Strike a key when ready . 


Two responses are possible: 
(1 Insert the new diskette and press any key to continue. 


{) Press Ctrl+C to stop the processing. 
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REM 


Format 


REM [remark] 


Explanation 


Use REM to display a comment on your screen during batch file 
execution. 


The maximum length of a remark is 123 characters. You can 
use spaces, tabs and commas as separators. You can also use 
REM to add space to your batch file for readability. 


Note 
If ECHO is OFF, REM comments are not displayed. 


Example 
The following is an example of a REM command: 


REM Archive backup files for security 
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SHIFT 


Format 


SHIFT 


Explanation 


SHIFT allows you to change the position of command line 
parameters to access more than 10 (%0 through %9) 
replacement variables. Execute the SHIFT command to get 
past the tenth parameter on the parameter list. The 
parameters on the command line are shifted one position to the 
left; the parameter in the %1 position moves to the 0% position. 
Each shift command moves all the parameters to the left by one 
more position. 


Example 


The batch file dirlist.bat in this example uses SHIFT to 
display directory listings of various specified directories or 
drives. At the command line you could type for example: 


C>DIRLIST a: \sales b:\sales\foreign\*.doc b:\clients 
The actual batch file is: 


echo=off 

rem This batch file calls DIR on a number of 
rem specified directories or drives 

: loop 

if "S$1$" == "" goto done 

dir /p %1 

shift 

pause 

goto loop 

:done 


echo Task complete 
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7.6 The autoexec.bat file 


The autoexec.bat file is a special batch file that DR DOS runs 
each time your computer is started. Autoexec.bat sets up your 
computer the way you want it each time the computer is 
switched on. For more information see Chapter 9, section 9.5. 


DR DOS Commands 


HIS chapter contains a complete list and description of the DR DOS 
commands. 


It also provides an explanation of command syntax and how to 
edit commands at the command line using the DR DOS 
command line editing, and extended command line editing keys. 


Note that batch processing subcommands are explained in 
Chapter 7, and the config.sys file commands in Chapter 9. 
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8.1 Command syntax explained 


The syntax of each DR DOS command is a combination of the 
following items: 


filename 


dirname 


filespec 


wildspec 


The command’s filename. Some command 
filenames can be abbreviated, as explained in 
the text of this chapter. You do not need to 
include the file extension. To use an external 
command you must have it’s corresponding 
“program file” in your current directory, or in 
one of the directories pointed to by the path 
statement. 


Represents a directory name. 


Represents a file specification which can include 
some or all of the following: 


[d:][dirpath]filename[.ext][;password] 
where 


d: is the drive (optional), for example C: 
dirpath is the location of the file in the 
directory structure, for example \work\ or \. 


filename is the 1-8 character name of the file. 


[.ext] is the optional 1-3 character file 
extension, for example -bat. 
[;password] is the optional 1-8 character 
password. 


This is the same as a filespec, but it indicates 
that you can use the wildcard characters ? and * 
in filenames and extensions to specify groups of 
files. 


device 
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If you see the symbol @ in front of a filespec, it 
means you can insert a filename containing a 
list of files which you want the command to 
have an effect on. You can create a text file 
(using EDITOR) containing several different 
filenames, you can even use wildcard characters 
in the names: 


* doc 
sample.txt 
henry.bak 


and call it source.fl, and then give the filename 
source.fl as part of the command. Note that 
each filename in your text file must be placed on 
a new line. Note that you cannot use wildcard 
characters in the filelist name (in our example 
source.fl). 


For example: 


If you want to give one password to a group of 
related files like those above, instead of issuing 
the command over and again for each file, type: 


PASSWORD @source.fl /r:mycode 


this assigns the password MYCODE to all the 
files,*.doc, sample.txt and henry.bak in the 
subdirectory from which you gave the command. 
The @ symbol tells the PASSWORD command 
that the filename specified is a “list of 
filenames”. 


Using the @ symbol is like using wildcard 
characters, except you have the advantage of 
being able to specify unrelated filenames at one 
time. 


Represents a peripheral device, for example prn. 


Square brackets mean an optional clause in a 
command. Type what is shown in the brackets, 
do not enter the brackets into the command 
line. For example for [/C], you type /C. 


A vertical bar means either/or, for example 
ON | OFF. Choose one or the other of the 
separated items. Do not type the vertical bar. 
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command 


Note 


Three periods means you can repeat an item, for 
example if a filespec or wildspec is followed by 
..., it means you can have multiple file or 
wildspecs on one command line. So instead of 
typing two commands like this: 


FIND error *.C 
and 
FIND error *.H 


you can put the wildspecs *.C and *.H on the 
same command line, as follows: 


FIND error *.C *.H 


This means enter a number within a specified 
range. The command explanation gives the 
range of valid numbers. 


Any parameter or option entered on a command 
line after the command name. 


All punctuation (excluding the special cases listed above) 
should be entered as shown. 
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8.2 Editing commands at the command line 


DR DOS has powerful command line editing features to save 
you effort when typing commands. In particular, it can store in 
memory the commands you have issued recently. This saves 
you for example having to retype a command line if you make a 
typing error. By using certain keys you can redisplay the 
command, edit it and reissue it. 


Say you mistype the ERASE command: 
C>efase myfile.doc 


The error message: 
Command or filename not recognized 


is displayed. Although you have entered the command by 
pressing Enter, it is not lost, but stored in a special area of 
memory called a “buffer”. You can use the command line editing 
keys to correct the command and then re-enter it: 


Press T To display the previous command line. 


Press <— To move the cursor using the left arrow key 
until it is on top of the “f’. 


Press Del To delete F from the stored line. 


Press Ins To turn on “insert mode”. 
Type R To enter R into the stored line. 
Press To re-enter the correct command. 


Similarly the command: 


C> erase myfle.doc 


can be corrected by the following keystrokes: 


Press T To display the previous command lines. 
Press <— To move the cursor until it is on the “1”. 
Press Ins To switch on “insert mode”. 

Type I To add i to the display. 

Press 4 To re-enter the correct command. 


The command line editing keys comprise the function keys F1 
to F6, Del, Ins, Backspace and Ese. Their functions are listed 
in Table 8-1. 
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Table 8-1 DR DOS command line editing keys 


Key 


Meaning 


Ese 


Backspace 
Del 


Ins 


Fl 
F2 
F3 
F4 


F5 


F6 


Cancels the command line and leaves the 
original contents of the stored line unchanged. 


Deletes the previous character in the stored line. 


Deletes the current highlighted character in the 
stored line. 


Allows you to insert characters into the stored 
line. Any characters you type are displayed on 
screen. You can switch Insert mode off by 
pressing Ins again. 

Copies and displays one character from the 
stored line. 


Followed by a character, copies all characters up 
to a specified character. 


Copies all remaining characters from the stored 
line to the display. 


Followed by a character, deletes all characters 
up to a specified character in the stored line. 


Copies the current line (as edited) to the stored 
line. The line is not edited as a command and 
can be edited further if desired. 


Specifies the End-Of-File marker (Ctrl+Z), for 
example if you create a file using the COPY 
command pressing F'6 when you have finished 
entering the text, gives you the marker which 
indicates this is where the file ends, for example: 

COPY CON test.bat 

DIR a: 

DIR b: 

F6 
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Extended command line editing 


DR DOS offers additional editing keys to those described in 
section 8.2. Table 8-2 lists the extended editing keystrokes and 
their meanings. 


Table 8-2 DR DOS extended command line editing keys 


Keystrokes Meaning 

< or Ctrl+S Move one character to the left. 

> or Ctrl+D Move one character to the right. 

T or Ctrl+E Move to the previous command in 
memory. 

L or Ctrl+X Move to the next command in 
memory. 

Enter or Ctrl+M Enter the command line 

Backspace 

or Ctrl+H Delete the character to the left of the 
cursor. 

Del or Ctrl+G Delete the character at the cursor. 

Ins or Ctrl+V Switch insert/overstrike mode on or 
off. 

CtrlLA Move one word left. 

Ctrl+F Move one word right. 

Home or Ctrl+Q Move to the beginning of the line. 

End or Ctrl+W Move to the end of the line. 

Ctrl+T Delete a word. 

Ctrl+Y Delete a line. 

Ctrl+B Delete to the beginning of the line. 

Ctrl+K Delete to the end of the line. 

Ctrl+R Start Command line search, see 
below.* 

Ctrl+_ Turns Command line search mode on 


or off. The default is off, see below.* 
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*Searching for commands 


Ctrl+R displays the last matching command. You can then 
enter the displayed command again, or edit it before pressing 
Enter. 


Ctrl+_ switches on a more sophisticated version of command 
line search. When it is active, each time a character is typed, 
DR DOS displays the last command which matches the first 
character typed on the command line. For example, if you type 
d then the last command you entered which started with the 
letter d is displayed. If you type c, then the last command you 
entered which began with the letter c is displayed. 


Command line search remains on until you type Ctrl+_again. 


Note 

Some of these commands are only available if you have 
included the command line HISTORY= in your config.sys file. 
This may have been set up when DR DOS was installed, but if 
you find it was not, you can use SETUP to reconfigure it, see 
Chapter 9. 


DR DOS control key combinations 


There are certain control key combinations within DR DOS 
which can be used to carry out particular tasks, they are listed 


below: 

Ctrl+C or 

Ctrl+Break Stops commands when they are 
running. The processing of the 
command is stopped, and the 
command prompt returned. 

Ctrl+P Switches between echoing text to the 
screen, or to a printer. 

Ctrl+S or 

Pause Suspends scrolling. To start scrolling 


again, press any key. 
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8.3 Command summary 


This section contains a table listing all the DR DOS commands 
with a brief summary of what they do. This includes which are 
internal and external (internal commands are stored in 
memory for quick access and external commands are stored on 
disk and tend to be commands that are used less often, see 
Chapter 2). All external commands have a /Help option that 
displays a quick reminder of the command and its parameters. 
The /H switch should appear following the selected command 
(for example APPEND /H). Commands that are special to DR 
DOS, or have extended functionality, are indicated with an 
asterisk (*) . 


Table 8.3 DR DOS command set 


Command Explanation Status 

APPEND Specifies a search path for data files and overlays. External 

ASSIGN Reassigns a drive letter to a different drive or Internal 
subdirectory. 

ATTRIB Displays and modifies a file’s attributes. External 

BACKUP Makes security copies of files, directories andhard External 
disks and diskettes. 

BREAK Allows you to break out of programs running under Internal 
DR DOS. 

CACHE A disk cache program used to speed up disk access. External * 

CHCP Changes a specified code page. Internal 


CHDIR/CD Shows the path to, and changes the current directory. Internal 
CHKDSK Checks the integrity of data on disks and restores External 


corrupted disks. 
CLS Clears the display screen. Internal 
COMMAND _Loadsa second copy of the DR DOS default External 
command processor. 
COMP Compares files character by character. External 
COPY Copies or combines files. Internal 


CITy Changes the current console device. Internal 
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Command Explanation Status 

CURSOR Allows the user to modify the displayed cursor, and External 
control the frequency of the flash. 

DATE Displays and changes the date. Internal 

DEL Erases files. Internal 

DELQ Erases files but queries you before doing so. Internal 

DIR Displays the files in a directory. Internal 

DISKCOMP Compares entire disks of the same format. External 

DISKCOPY Copies entire disks of the same format. External 

EDITOR A program used to display write, and change External 
text files. This program is described in Chapter 5. 

ERAQ Erases files but queries you before doing so. Internal 

ERASE\ERA Erases files. Internal 

EXE2BIN Converts executable files (.exe) to binary. External 

EXIT Returns you to a running application. Internal 

FASTOPEN __ Increases the speed with which disk files can be External 
accessed. 

FDISK Formats hard disk partitions or gives information External 
on partitions for DR DOS. 

FILELINK A utility used to transfer files between computers External 
via their serial communication ports. 

FIND Finds a string of characters within a group of files. External 

FORMAT Formats diskettes so they can be used. External 

GRAFTABL _ Displays extra international characters on a External 
Color Graphics Adapter. 

GRAPHICS Allows you to print graphics using the PrtSer key. External 

HILOAD Allows you to load an application into upper memory Internal 
at startup. 

JOIN Joins a disk drive to an empty subdirectory on External 
another disk drive. 

KEYB Allows use of non-USA keyboard External 

LABEL Creates or modifies a label on a disk External 


8: DRDOS Commands 115 


Command Explanation Status 

MEM Displays a range of information on the way your External * 
computer is using memory. 

MKDIR/MD Creates a subdirectory. Internal 

MODE Sets monitor type, printer type, and COM port, External 
also used with code page switching. 

MORE Causes DR DOS applications’ output to the console Internal 


to be displayed a screenful at a time. 


NLSFUNC Provides support for extended country information External 
and allows the CHCP command to be used. 


PASSWORD _ Sets password protection to files or paths. External * 

PATH Sets a search path for commands or batch files. Internal 

PRINT Prints files. External 

PROMPT Modifies the command prompt. Internal 

RECOVER Recovers corrupted files from disk. External 

RENAME Renames files or moves files between subdirectories Internal 

/REN on the same disk. 

REPLACE Selectively copies files. External 

RESTORE Restores files backed up with the BACKUP command. External 

RMDIR/RD Removes specified subdirectories. Internal 

SET Inserts strings into the command processor’s Internal 
environment. 

SETUP A program used to change system configuration External * 
values. Note this program is described in Chapter 9. 

SHARE Installs file sharing. External 

SID A debugging program. This program is describedin External * 
Appendix D. 

SORT Reads data from the standard input device, sorts and External 
then writes it to the standard output device. 

SUBST Allows you to replace a path with a drive. Internal 

SYS Transfers DR DOS system files from the source External * 


drive to a specified drive. 
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Command Explanation —————“‘C‘;!!!UUUWUWUUUCUSMhtat 

TIME Displays and changes the time of day. Internal 

TOUCH Resets time and date stamps on a file or group of files. External * 

TREE Displays a hierarchical path of files, directories and External * 
subdirectories. 

TYPE Displays the contents of a text file on screen. Internal * 

VER Displays the DR DOS version number of the Internal 
operating system in use. 

VERIFY Switches the Verify option on or off which causes Internal 


DR DOS to check that data is correctly written to 
disk after each write operation. 


VOL Displays the disk volume label. Internal 
XCOPY Selectively copies groups of files. External 
XDEL Selectively deletes groups of files and subdirectories. External * 
XDIR Extended directory list with switches to display, for External * 


example, files in subdirectories. 
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8.4 The DR DOS command set 


The commands in the DR DOS command set are described like 
this: 


Command name 


"~~ The DR box indicates that the command is special to, or 
extended in, DR DOS. 


Format 


The command syntax in full 


Explanation 


What the command is and does. 


Command switches or options 


A description of what the command switches (if any) do. 


Remarks 
Any relevant notes or tips on using the command. 
Examples 


Where appropriate examples of use are given. 
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APPEND 
Format 
APPEND [/H] d:path [;[d:]path...] [/X:ON|OFF] 


[/E:ON|OFF] [/PATH:ON|OFF] 


Explanation 


APPEND enables programs to look in other specified 
directories for files that it cannot find in your current directory. 
It is similar to the PATH command. PATH is used to search for 
.com, .exe and .bat files. APPEND is used when programs 
want to search for any other type of file. 


The APPEND command is generally used with older-style DOS 
applications which do not support pathnames. Normally you 
should not need this command, unless your applications 
documentation advises you to use it. 


The two main forms of the command are: 
1 APPEND followed by the /X switch. 
C1 APPEND followed by pathnames. 


Before you enter an APPEND command to specify a search 
path, you can issue APPEND with the /X:ON switch. This 
causes APPEND to work with programs that use the Search 
First, Find First, and Execute functions. To switch it off again, 
type APPEND /X:OFF. 


Caution Use this option with care; it can lead to problems when 
used with certain application programs. Some applications 
cannot use the APPEND command; you will find that they 
read files successfully from directories other than the 
current directory, but they can only create files in the 
current directory. This results in two copies of files: an 
edited version on the current directory and the unedited 
version left unchanged on the original directory. 
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Command switches 


/H Displays help text. 

[X:ON Append ON for search and exec functions. 

/X:OFF Append OFF for search and exec functions (the 
default). 

/E:O0N The append path to be kept in the DOS 
environment. 

/E:OFF The append path not to be kept in the DOS 


environment (the default). 


/PATH:ON Append will apply to files having pathnames 
(the default). 


/PATH:OFF Append will not apply to files having pathnames. 


APPEND with pathnames 


APPEND followed by pathnames is used to specify a search 
path. Once entered, APPEND specifies where DR DOS looks for 
files if it cannot find them in the current directory. You can 
specify several search directories provided each is separated by 
a semi-colon (;). The total length of the APPEND command 
cannot exceed 128 characters. 


To return to the default value of no search path, type: 


A>APPEND ; 


APPEND and BACKUP 


Before you use the BACKUP command you should cancel the 
APPEND search string by entering APPEND ; 
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Examples 


The following command sets up a search path such that if a 
program cannot find the file you want in your current directory, 
it looks in the directory c:\spreads\cashflow. 


A>APPEND c:\spreads\cashflow 


The following example extends the search path so that the 
program also looks in the directory \oldones on the A: drive. 


A>APPEND c:\spreads\cashflow;a:\oldones 
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ASSIGN 


Format 
ASSIGN 


ASSIGN d=d [d=d] [/A] 


Explanation 


ASSIGN causes commands that would access a certain drive to 
access a different drive. It is mainly used when you have a 
program set up to access a certain drive like drive A: but the 
information to access is stored on a different drive (for example 
drive C:). You can use ASSIGN rather than re-installing or 
modifying your program. 


To cancel an ASSIGN statement, simply type ASSIGN on its 
own. 


Command switches 


/A Displays the current status and assignment. 


Remarks 


Do not use the following DR DOS commands when an ASSIGN 
command is in effect: 


BACKUP 
DISKCOMP 
DISKCOPY 
FORMAT 
LABEL 
PRINT 
RESTORE 
SUBST 
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Examples 

The following ASSIGN command reassigns drive A: as drive C:. 
C>ASSIGN a=c 

So for example, if you type: 

C>DIR a: 


you will now see a DIR listing of the C: drive. Typing ASSIGN 
/A will give you the current assignment made, in this case: 


A:=>C: 
If you type : 
CS DIK & 


you will also see a DIR listing of the C: drive. 


Caution 


The above example means that any command issued that 
includes the drive letter A is read as if it was the letter C. 
This means drive A: is inaccessible to you. In general, do 
not use ASSIGN unless you are running a specific program 
that requires it. 


This command cancels any ASSIGN statements made. 


C>ASSIGN 
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ATTRIB 


Format 


ATTRIB [/H] [+|-A] [+|-H] [+|-R] [+1-S] [@]wildspec[...] 
(/P] [/S] 


Explanation 


ATTRIB displays a file’s attributes, and can be used to switch 
these attributes on or off. The attributes included are the 
archive, hidden, read-only and system attributes. 


The archive attribute shows that a file has been modified. The 
ATTRIB command enables you manually to switch the archive 
bit on or off for any given file. This is useful when you use the 
BACKUP switch /M which copies all files with the archive bit 
set. 


The system attribute, when switched on, prevents DIR from 
displaying the file and COPY from copying it unless the /S 
switch is specified. It is used for the DR DOS system files that 
you do not need to see in everyday work. 


Note 


Both COPY and XCOPY have switches that allow you to copy 
system files. 


A file that is set to be read-only cannot be erased, renamed, or 
altered in any of the normal ways. Setting a file with the 
read-only attribute should protect it from being inadvertently 
altered. However, the REPLACE, TOUCH and XCOPY 
commands all have /R switches that allow you to alter 
read-only files. 
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Command switches 


/H Displays help text. 

+A Sets the archive attribute (-A switches it off). 

+R Sets the read-only attribute (-R switches it off). 

+H Sets the hidden system file attribute. (-H 
switches it off). 

+5 Sets the system attribute (-S switches it off). 

/P Pauses after each screenful in a long display. 

IS Sets the file attributes in the subdirectories 


associated with the chosen directory. 


Examples 


This example switches on the archive attribute for all the files 
with the extension .new in the current directory. You can then 
use a command like XCOPY /M to copy all the files marked for 
archiving. 

A>ATTRIB +A *.new 


This command switches off the read-only attribute for all the 
files with the .bas extension in the current directory, and any 
associated subdirectories. 


A>ATTRIB -R *.bas /S 
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Caution 


BACKUP 


Format 


BACKUP [/H] source_drive [filespec] destination_drive 
(/S] [/F] [/M] [/D:date] [/T:time] [/A] 
(/L: [path] filename.ext]] 


Explanation 
BACKUP makes backup copies of your files. 


You can backup whole hard disks and diskettes, or directories, 
groups of files, or even single files. The backed up files must be 
restored using the RESTORE command before they can be used 
as DR DOS files. 


DR DOS BACKUP and RESTORE programs are compatible 
with DOS BACKUP and RESTORE programs, version 3.30 or 
later. Files backed up with DR DOS BACKUP can be restored 
with a different DOS RESTORE and vice versa. 


Password-protected files and subdirectories are NOT 
backed up, unless the global password is set before running 
BACKUP, and the files have been protected with the same 
password. 


Command switches 


/A Displays help text. 


/S Backs up the current directory and all the 
subdirectories associated with it. 


You must be in the root directory and specify /S 
if you want to backup an entire disk. The 
default is to backup only the current directory. 


/F Formats the destination diskette before copying 
the files. 


Backs up all the files on the disk modified since 
the last backup. (This switch actually copies all 
the files for which the archive bit is set. You can 
set the archive bit manually by using the 
ATTRIB command.) 


/D:date 


/T:time 


/A 


/L:filename 
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Backs up only the files that have been modified 
since the specified date. The date format you 
use is governed by the COUNTRY command in 
your config.sys file, but is usually the one 
commonly used in your country: month/day/year 
in the US, day/month/year in most European 
countries, and year/month/day in Japan. 


Backs up only the files that have been modified 
since the specified time. The format to use is 
hh:mm:ss. 


Adds new files to the backup disk without 
erasing existing files (the default is to overwrite 
all the existing information on the backup disk). 


Creates a file recording the date and time of 
backup and number of the backup diskette on 
which each file is stored. The default filename 
for this backup log is backup.log, though you 
can specify another filename. DR DOS places 
the log in the root directory of the source disk. If 
you specify a name for the log file that already 
exists on the root directory, DR DOS appends 
the new log information at the end of the 
existing log file. 


BACKUP reports any errors using the codes shown in Table 8-4. 


Table 8-4 BACKUP error codes 


Code 


Explanation 


Normal completion. 
No files found to backup. 


Some files not backed up due to file sharing 
conflict. 


Backup ended by Ctrl+Break command. 


Backup ended by an error. 
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This feature can be useful in creating batch files with an IF 
ERRORLEVEL statement in them to improve the process, see 
Chapter 7. 


Remarks 


Do not use the BACKUP program with disks affected by an 
ASSIGN, JOIN or SUBST command. 


When you make a backup, label and number all your diskettes 
consecutively to make it easier when you come to restore them 
using the RESTORE command. 


If you do not want files overwritten on your backup diskettes, 
specify the /A switch in the command line. 


For information on taking backups, see Chapter 4. 


Examples 


This command backs up the entire hard disk onto diskettes. 
When each diskette is full, you are prompted to remove it and 
insert the next one 


C>BACKUP'c:\ a: /s. 


Note 


To backup a full 20 Mbyte hard disk you may need up to 60 
diskettes, though this number varies with the capacity of your 
diskette drive. 


This command backs up all the .doe files that have been 
modified since the last BACKUP on directory \ww and on the 
subdirectories associated with it. 


C>BACKUP ec:\ww\*.doc a: /s /m 
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BREAK 


Format 


BREAK [ON|OFF] 


Explanation 


BREAK when switched ON allows you to stop a running 
program by pressing Ctrl+Break. The program will then stop 
the next time it tries to call any DOS function, such as 
accessing the disk. 


If BREAK is OFF (the default value), you can only issue a 
Ctrl+Break command when the program you want to stop is 
performing standard input or output operations such as 
printing or outputting to the console. 


If you type BREAK on its own, you see the current BREAK 
value. 


Examples 


This switches BREAK ON. BREAK remains ON until you issue 
another BREAK command or restart DR DOS. 


A>BREAK ON 


This shows the current status of the BREAK command. 
A>BREAK 


BREAK = off 
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CACHE 


Format 


CACHE [/H] [/S=nnnn] [/X] [/E] 


Explanation 


Accessing data on a hard disk can be time consuming. To speed 
this process up you can use the CACHE command to set up an 
area of RAM memory which acts as a buffer, storing a copy of 
data frequently read from disk. Everytime your applications 
attempt to access information on disk, a check is first made to 
see if a copy of the data is already in the cache. If it is, the copy 
in the cache is used instead which can be much faster than 
accessing the disk itself. Caches can be very useful if your work 
involves applications that need to access the same data over 
and over again, like a database or spreadsheet. 


You set up the size of the cache using the /S switch. The cache 
can be set up in conventional, extended or expanded memory. 
The default is to set it up in conventional memory. 


When CACHE is loaded, to see its current status type CACHE 
with no parameters. You see a display below the copyright and 
title lines, similar to this: 

1 drive cached in 123 track buffers 


2091 K Bytes of Extended Memory used 
69% of CACHE in use with a 74% hit rate. 


The report on CACHE shows the number of drives and tracks 
cached, the amount and type of memory used, and the 
efficiency of the cache. 


Command switches 


/H Displays help text. 
/S=nnnn Buffer size in Kbytes (in the form /S=2048). 
[X Sets up the cache in expanded memory. 


/E Sets up the cache in extended memory. 
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Remarks 


CACHE can be installed using the SETUP program, or by 
directly editing the config.sys file and adding a DEVICE = 
statement, see Chapter 9. 


If you want to fine tune your cache, start with the largest 
possible memory size, and then after running a typical 
application (that is one of the applications you use often), note 
the use and hit rate figures by displaying the CACHE status 
report. (A cache hit is when the cache is accessed and valid data 
is found within.) Repeat this process, reducing the memory 
allocated to the cache each time and then noting the new use 
and hit values. Continue until the memory size is reduced to its 
lowest value before the hit rate begins to drop. This will vary 
according to the disk and application used. 


Examples 


This command installs CACHE with 512 Kbytes of expanded 
memory. 


C> CACHE /X /S=512 
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CHCP 


Format 


CHCP [cp] 


Explanation 


This command changes (selects) the specified code page for DR 
DOS and for all the devices which support code page switching. 


The parameter cp is the code page number that you want to 
select. If it is omitted, the currently selected code page is 
displayed. 


Typing CHCP on its own displays the current code page. 


Remarks 


You must load NLSFUNC before you can use CHCP, see the 
explanation for NLSFUNC in this chapter. 


You must have prepared the code page (with the MODE 
PREPARE command) before you can select it with CHCP. 


For CHCP to work correctly, the COUNTRY statement must be 
included in the config.sys file. If you use the INSTALL or 
SETUP program to set up code page switching, this is done 
automatically. 


All printers supporting code page switching must be switched 
on and be online when CHCP is used. 


For more information on code page switching, see Chapter 10. 


Example 


The following command changes the code page on all devices 
supporting code page switching to 437. 


C>CHCP 437 
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CHDIR/CD 


Format 
CHDIR [d:]{\] 


CHDIR [d:]dirpath 


Explanation 


The CHDIR (change directory) command allows you to move 
between subdirectories on your disk. Use CHDIR to change the 
current directory on a drive and display the current directory 
path. When no directory is specified, CHDIR displays the 
sequence, called the path, of hierarchical directories leading to 
the current directory. If a path is specified, CHDIR makes the 
last directory in the path the current directory for the current 
drive or the drive specified. The short form of the CHDIR 
command is CD. 


CHDIR special characters 

To help you move between directories, CHDIR responds to two 
special characters: 

\ (backslash) 


Enter a backslash alone with CHDIR and you are returned to 
the current or designated drive’s root directory. For example, 
the command: 


A>CHDIR C:\ 


makes the root directory on drive C: the current directory. 
.. (two periods) 


Enter two periods (..) with CHDIR and you are returned to the 
next highest (that is, closer to the root) directory. 
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For example, if the directory bonus in the path 
accounts\wages\bonus is the current directory, the 
command: 


A> CHDIR .. 


makes wages the current directory. 


About directories 


You can create directories using the MKDIR command. 


You can access files in a directory by preceding the filename 
you want with a directory path, or by using CHDIR to change a 
drive’s current directory to the desired directory. 


Making a directory the current directory 


There are two ways to make a directory the current directory: 
“1 Enter CHDIR with the directory’s path. 


1 Enter CHDIR with a drive specification and a path. Note 
that this changes the current directory on the specified drive 
only. 


If the directory you are currently in is not part of the path to 
the directory you want, you must specify the complete path 
from the root, preceding the first directory with a backslash. 


How to display the current path 


The path to the current directory is displayed when you enter 
CHDIR with no parameters. You can display the path to the 
current directory on another drive by entering the drive’s name 
as the only parameter. Note that a path consisting of just a 
drive and a backslash (\) indicates that the root directory is the 
current directory. 
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Examples 


The following command makes personal the current directory. 
The backslash that precedes clients indicates that the path to 

personal begins from the root of drive C:, not from the current 
directory. 


C>CHDIR \clients\personal 


This command makes the drive C: root directory the current 
directory. 


C>CHDIR \ 


This command makes memos the current directory on drive A:. 
All references to A: now access this directory. 


C>CHDIR a:\wordproc\memos 
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CHKDSK 


Format 


CHKDSK [/H] [d:][wildspec] [/A] [/B] [/C] [/D] [/F] 
(/L] (/M] {(/P] [/R] [/S] [/V] 


Explanation 


The CHKDSK (check disk) command scans a disk and checks it 
for two things: space allocation and spacing errors. It then 
produces a disk and memory status report which shows how 
much total space is left on the disk, the amount of space in use 
in bytes and the number of files (including hidden files). The 
report includes the amount of memory available. It also reports 
on any errors found. If you do not specify a disk drive, the 
current drive is assumed. 


Atypical disk status report would look something like this: 
Volume MYDISK created 2 Apr 1989 13:44 


362,496 bytes total disk space 
246,784 bytes in 20 user files 
115,712 bytes available on disk 


655, 360 bytes total memory 
543,184 bytes available 


It is a good idea to check your disk(s) on a regular basis to keep 
account of how much space you have used, and to check for any 
errors. 


CHKDSK will not correct any errors found unless you ask it to 
by specifying the /F switch. This is because correcting errors 
often involves altering the File Allocation Table and so may 
mean loss of data. (The File Allocation Table or FAT is a kind of 
index which DR DOS uses to locate your files and allocate space 
to create new files.) 


As the CHKDSK program analyzes the disk it looks for extracts 
of files that have got “lost” and “mixed up” so DR DOS can no 
longer tell which file they came from. These are called lost 
clusters. If any lost clusters are found CHKDSK displays a 
message like this: 


Five lost clusters found in 2 chains. 
Convert lost chains to files (Y/N)? 


8: CHKDSK 137 


Answer Y for Yes and the lost clusters are collected into files in 
the root directory with the name FILEnnnn.CHK 
(nnnn=numbers starting from 0000 to a maximum of 9999). 


You may be able to examine these file(s) in EDITOR or using 
the TYPE command (unless they are in binary format), to see if 
they contain any valuable data. Then recover any data you 
need, and delete the file(s). 


Answer N for No and the clusters are freed for use when new 
files are created. 


Remarks 

CHKDSK does not work on drives used in ASSIGN, SUBST, or 
JOIN commands. 

CHKDSK does not work on networked drives. 


CHKDSK followed by a file specification will check that the 
specified files are allocated contiguous clusters on disk. Any file 
that consists of discontiguous clusters is displayed. 


You can check diskettes as well as hard disks using CHKDSK, 
however make sure the diskette is in the diskette drive before 
you issue the command. For example: 


C>CHKDSK a: /f 


This command checks a file has been allocated contiguous 
clusters for the best performance. 


You can send your disk status report directly to a file by typing: 
C>CHKDSK >d:filename 

(Do not use the /F switch if you redirect CHKDSK output.) 

For example: 


C>CHKDSK a:report 
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Command switches 


/A 
/A 


/C 


/F 


Displays help text. 


Shows only the total amount of conventional 
memory, and free memory available after the 
operating system and other programs are 
loaded. 


Mark bad clusters. The /B switch searches all 
the files on a disk to locate any bad clusters. 
This switch can be used to check the integrity of 
the file system, (for example following errors 
from other CHKDSK switches). 


Displays cluster numbers of all the bad files. 


Locates erased directories on a disk so that in 
the event of disk corruption, you can use a 
suitable disk editor to restore individual files 
and directories. 


The /F(ix) switch allows CHKDSK to write 
corrections back to the disk. If you do not 
specify /F, CHKDSK does not modify the disk 
when errors are found. The default is read-only 
(that is, do not fix). 


Rebuild cluster links. /L attempts to rebuild a 
corrupted File Allocation Table (FAT) if for some 
reason it has become corrupted. You must zero 
any corrupted areas on the disk before using 
this switch. 


Verifies the disk for bad clusters and maps bad 
clusters. This switch is used to mark bad 
clusters after formatting. It can be used if a file 
has become corrupt, or if errors were 
encountered writing to a specific location on a 
disk suggesting a bad cluster. By marking the 
cluster as bad, DR DOS would not attempt to 
allocate that cluster again. 


Displays parent clusters for all directories. This 
switch is used to examine a directory tree, when 
checking the integrity of a disk. 


/S 
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Recover root directory. /R recovers lost 
directories that were contained in the root 
directory. You must remove any corrupted files 
in the root directory. 


Shows the actual file space. This is a total of 
actual bytes taken up by the files on the disk, as 
opposed to clusters taken up on the disk, that is, 
the actual number of bytes of filespace occupied 
rather than disk space. 


Verbose display. /V displays additional 
information while CHKDSK is running and may 


be useful when trying to locate corrupted data 
on a disk. 
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CLS 


Format 


CLS 


Explanation 


CLS clears the display screen. If foreground and background 
colors were selected previously, the colors will be unchanged. 
Otherwise, the screen is set to white characters on a black 
background. It is useful if you want to start with a fresh screen. 


Example 
To start with a fresh screen, from the command prompt type: 
CLS 
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COMMAND 


Format 


COMMAND [d:][dirpath] [CTTY-devicename] [/E:nnnnn] 
{/P] [/cC string] 


Explanation 


COMMAND starts a second copy of the DR DOS default 
command processor COMMAND.COM. COMMAND.COM is a 
program which is loaded into memory every time you start DR 
DOS. It processes the commands you issue. In the case of 
internal commands, COMMAND.COM can execute the 
commands directly. In the case of external commands and other 
applications, it arranges for the appropriate programs to be 
loaded from their files on disk. The COMMAND options are 
most commonly used by applications when they execute DOS 
internal commands. 


The command processor executes in an environment which is 
the collection of all system variables such as PATH and 
PROMPT. When a command processor is started, it inherits the 
environment from its parent. Any changes made to the new 
environment (for example using SET or PROMPT), do not 
affect the primary environment. 


The command processor resides in memory in two parts: the 
resident part which remains in memory all the time, as long as 
DR DOS is running, and the transient part which may be 
overwritten by some external commands or applications. If this 
happens, then the resident part can reload the transient part 
from the disk file COMMAND.COM in the directory specified 
by the d: and dirpath options, when the application completes, 
and before the next command is processed. 


The second copy of the command processor remains in memory 
until you issue an EXIT command. 


You can specify a device name in the command syntax if you 
want to use a different device for input and output, e.g. AUX. 
See also the CTTY command description. 


Note 


COMMAND entered on its own causes a new copy of the 
command processor to be loaded. 
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Command switches 


/E:nnnnn 


/C string 


The size of the environment in bytes where 
nnnnn is in the range 512 (minimum) to 32,751 
(maximum). If you specify a value outside this 
range, the command defaults to the minimum 
value. 


Results in this copy of the command processor 
being fixed permanently in memory. The EXIT 
command is disabled. Also causes the 
autoexec.bat file to be executed when 
COMMAND.COM starts. 


Makes the command processor carry out the 
command(s) or programs specified in the string 
and then exit and return to the primary 
command processor. If this switch is used with 
other switches it must be the last one specified 
on the command line. 
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COMP 


Format 


COMP [/H] [wildspec] [wildspec] [/A] [/M:n] 


Explanation 


This command compares two files character by character and 
reports any character mismatches. COMP also reports if the 
End-Of-File (EOF) character is missing from any file that it 
examines. 


Wildcards are allowed in the file specification. If you leave out 
the filenames altogether, COMP assumes a wildspec of *.* and 
prompts your for the source and destination. 


Command switches 


/H Displays help text. 


/A Displays the reported mismatches in ASCII 
format. (The default is to display them in 
hexadecimal format.) 


/M:n Specifies the maximum number of mismatches 
before COMP terminates automatically; 10 is 
the default, 0 allows an unlimited number of 
mismatches. 


Examples 


The following command compares all the .doe files in directory 
e:\address with files of the same name on the root directory of 
a diskette in drive A: 


C>COMP \address\ *.doc a:\ 


The following command compares the file today.doc with the 
file lastweek.doc to see if the two contain identical 
information. The two files are both in the same directory, which 
is the current directory. Only five mismatches are allowed 
before COMP terminates automatically. 


C>COMP today.doc lastweek.doc /M:5 
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Password-protected 


files 


COPY 


Format 


To copy files 


COPY device|wildspecl[/switch] 
[+wildspec2[/switch]...] device|filespec[/switch] 
[/A] [/B] [/V] [/S] [/C] [/2] 


To combine files 


COPY wildspecl+wildspec2 [...] wildspecn 


Explanation 


The main function of the COPY command is to copy one or 
more files to another location either on the same disk or 
another disk. It can also be used to combine files together into 
one file, to create files and to send files to a printer. 


COPY can be used with password-protected files but note: 
O COPY does not prompt for a password. 


(1) The destination copy of the file will not have 
password-protection unless you assign a password with the 
PASSWORD command. 


Copying files 
Wildspecl is the source which must always be given. Wildspec2 


is the destination. The source and destination wildspecs 
comprise the complete path, filename and filename extension. 


If you omit the destination wildspec, the “copy” is created in the 
current directory of the disk in the default drive, with the same 
name as the source file. You cannot copy a file to itself. 

If you use wildcards in the source wildspec, the names of the 
files are displayed as they are copied. 


If you type: 
C>COPY *.* reports 


all the files in the current directory would be copied to the 
directory reports. However, if the directory did not exist, ALL 
the files would be copied to a single file called reports in the 
current directory. 


WARNING 
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Specifying the destination wildspec 
1) If wildspec2 is a drive name only for example: 


C>COPY file.txt a: 
the file is copied to the specified drive with its original name. 
If you enter a destination file specification that matches one 


already on the destination drive, the copy overwrites the 
existing file. 


2) If wildspec2 is a filename only for example: 
C>COPY file.txt new.txt 


the original file is copied to a file on the current drive with the 
name given. Note that this is a method you can use COPY to 
rename a file or files. 


3) If wildspec2 includes a drive name: 


C>COPY file.txt a:new.txt 


the original file is copied to the file on the designated drive. 


Note 


To copy entire directories and subdirectories, use the command 
XCOPY. 


COPY has several switches you can add to either the source or 
the destination wildspec. 
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Command switches 


/A 


/S 
/C 


IZ 


Causes the file to be treated as an ASCII (text) 
file. 


When you specify the /A switch with the source 
specification, the file contents are copied up to, 
but not including, the first Ctrl+Z 
(End-Of-File) character. Remaining file 
characters are not copied. 


Using /A with a destination specification adds a 
Ctrl+Z as the last character in the file, which is 
required by some word processors. 


When applied to the source wildspec, /B causes 
the file to be treated as a binary file; the entire 
file is copied regardless of any Ctrl+Z character 
found in the file. 


When you use /B with your destination 
wildspec, no end-of-file character (Ctrl+Z) is 
added. 


Note 


The /A and /B switches only need to be entered 
when you are combining ASCII and binary files. 
These parameters are not necessary to copy 
data, program or batch files. 


Causes COPY to compare the destination file 
with the source file contents to verify the 
accuracy of the copy. Because of the comparison, 
it takes longer to complete the copy with the /V 
switch. 


Includes system and hidden files in the copy. 


Asks for confirmation before copying each file. If 
you are combining multiple groups of files, it 
confirms each group by first source name. 


Zeros the top bit of every byte in the destination 
file. This switch should only be used with ASCII 
files. It is designed for use with older-style 
word processors which use the eighth bit in 
every byte to mark beginnings and ends of 
words. This means text written in such a word 
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processor would be unintelligable in a 
newer-style word processor. The /Z switch 
combats this problem.) 


+ Valid only in the source wildspec. It is used 
between wildspecs to indicate that the files are 
to be concatenated (combined). 


Examples 

To copy the file myfile from the current drive to drive B: 
A>COPY myfile b: 

To copy the file myfile.typ on drive B: to the current drive A: 
A>COPY b:myfile.typ 


This command duplicates the file myfile.typ in the same 
directory and names the copy yourfile.typ: 


A>COPY mpyfile.typ yourfile.typ 


You can copy a file from one drive to a different drive by 
specifying drive designations before the filenames. This 
example copies phone.Ist from drive B: to drive C:, and verifies 
the destination file against the source file for an exact match: 


A>COPY b:phone.|st c:phone.|st/v 


Other uses of the COPY command 


Combining files 


To combine a number of source files into a single destination 
file, type COPY followed by the filenames to be combined with a 
plus sign between them, enter a space between the two 
combined files and the destination file. 


C>COPY filel.txt+file2.txt result.txt 


The files are combined in the order in which they are listed, or 
if there is a wildcard, in the order they are re-encountered in 
the directory. The destination file is always the last file named. 


Caution If the files exist already, they are overwritten. 
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Displaying or printing 


files 


You should not combine files if one of the source files has the 
same name and extension as the destination file. 


Examples 


To combine the file myfile.typ on drive A: with yourfile.typ 
on drive B:, copy the file to drive C:, and name it result.typ: 


A>COPY myfile.typ+b:yourfile.typ result.typ 


Copying files fo a console or printer 


You can use COPY to display or print a file, by typing: 
COPY filespec device 


COPY can be used instead of TYPE to display or print a file. To 
perform this type of copy, enter CON or PRN as the destination. 
This command is valid only for text (ASCII) files, not 
application or program files. 


The printer and console device names are shown in Table 8-5. 


Table 8-5 COPY device names and descriptions 


Name Description 

CON Designate your screen when it is the destination 
and your keyboard when it is the source device. 

LPTn Designate your destination printers where n 
could be 1, 2, 3. 

PRN Designates your current printer. 

NUL Designates a dummy output device and is 
usually used for program testing. 

COMn Designates the serial ports where n could be 1, 
2, 3, 4. 

AUX Designates your current auxiliary port. 

Examples 


To read the file myfile from drive D: and display it on the 
console: 


A>COPY d:myfile con 
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To print all files with the file extension .txt on the current drive: 


A>COPY *.txt prn 


Creating a file with COPY 


You can create a text file using COPY by specifying the 
keyboard as the source device: 


C>COPY CON filespec 


When you specify CON as the source device, every character 
you type in is recorded in the destination file you specified, 
except line-editing characters such as Ctrl+H. 


Press Ctrl+Z or the F6 key when you have finished typing your 
file, and close it by pressing Enter. 


Examples 


To create a file called showme with the text this is my file, on 
the current disk type: 


A>COPY CON showme 
this is my file 
Ctrl+Z 


After you have pressed Ctrl+Z to add the End-Of-File marker 
(which says this is where the file finishes) and then pressed 
Enter, the command prompt is returned to the screen. 


The file showme may now be displayed by typing: 
A>COPY showme con 
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Cry 


Format 


CTTY device 


Explanation 


Normally DR DOS takes input from your keyboard and sends it 
to your screen. Using the CTTY command you can redirect 
input and output to a different device, like a serial terminal; 
see Table 8-6 for devices you can specify. 


Table 8-6 Devices you can specify with CTTY 


Devices Function 

CON Keyboard input and screen output. This is the 
default. 

AUX 

or COM1 First serial (communication) port 

COM2 Second serial (communication) port. 

Note 


Before connecting a device to a port, you may need to set the 
correct communication parameters for the port using the 
MODE command. 


Examples 


The following command hands over control to the device 
attached to the COM2 port, say a terminal: 


C>CTTY COM2 


To give control back to the keyboard type (from the terminal): 
C>CTTY CON 
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CURSOR 


Format 


CURSOR [/H] [/Snn] [/C] [OFF] 


Explanation 


On some types of displays (like LCD displays), the cursor blinks 
faster than the display can handle and so becomes a dim blur 
which is difficult to find. 


The CURSOR command provides an easily visible cursor for 
use on laptops and portable computers with long persistence 
Liquid Crystal Displays. CURSOR works on CGA, EGA and 
VGA displays. The usual hardware-generated cursor appears as 
a single line under the character on which it is placed, whereas 
the software-generated cursor produced by the CURSOR 
command, appears as a large block. It has a variable flash rate 
to suit your own preference and the quality of the display you 
are using. 


Command switches 


/H Displays help text. 


/Snn Sets the flash interval, where nn is a 2 digit 
decimal value giving the cursor flash interval in 
multiples of 1/20 of a second. The permitted 
values are 1-20. The default is 4/20 of a second. 


/C Enables CGA compatibility. This prevents the 
snow-like interference that could be caused by 
using the software cursor on a CGA screen. 


OFF Disables the software cursor, and restores the 
hardware cursor. 


Examples 


This command sets the software cursor with a flash interval of 
6/20 of a second: 


C:>CURSOR /s6 
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DATE 


Format 
DATE [mm-dd-yy] 


DATE [dd-mm-yy] 


DATE [yy-mm-dd] 


Explanation 
The DATE command displays or sets the month, day, and year. 


DR DOS has its own internal clock, which needs to be set using 
the DATE and TIME commands each time you start the 
computer or reset DR DOS. 


DR DOS maintains the internal clock for two reasons: 


1 To provide you and your applications continuous access to 
the date and time. 


Q To have the time available for file time and date stamping. 
(Time and date stamping records the current time and date 
whenever you create or update a file.) 


To be prompted automatically whenever you start or reset your 
computer, include DATE and TIME commands in your 
autoexec.bat file. (There is no need for DATE or TIME 
commands in your autoexec.bat file if your computer has a 
battery-backed real-time clock.) 


If you do not enter the date, DR DOS assumes one. The DATE 
command always lets you change the current date. When you 
enter: 


A>DATE 


the current date is shown and you are prompted: 
Date: day mm/dd/yy 
Enter date: 


where day is the day of the week and mm/dd/yy is the month, 
day, and year. 


8: DATE 153 


You can enter a new date or press Enter to keep the current 
values. To set the date from the command line prompt type: 


A> DATE mm-dd-yy 
You can use either a hyphen (-) or a slash (/) to separate your 
entries. The date values in this form are defined as follows: 


Q mm isa one- or two-digit number from 1 to 12 indicating the 
month 


Q dd is a one- or two-digit number from 1 to 31 indicating the 
day 


o yy is a two- or four-digit number indicating the year 
If you enter a date that is incorrect or out of range, you see: 
Invalid date specified 
Enter date: 
Enter the date as described above or press the Enter key to 
keep the previous value. 


Remarks 


The date display sequence has been preset according to the 
method used in the country where your system has been 
configured. The US form is mm-dd-yy, the European is 
dd-mm-yy and the Japanese, yy-mm-dd. You can change your 
configuration using the SETUP program or by making a 
COUNTRY entry in the config.sys file, see Chapter 9. 


If your system has a real-time clock, the DATE and TIME 
commands will automatically update it. 
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DEL 


Format 


DEL wildspec [/C] [/S] 


Explanation 


DEL has the same form as the ERASE and ERA commands. It 
removes the specified file or files from the directory. The file 
specification can identify a particular file, or it can indicate a 
group of files through the wildcard characters * and ?. 


After you erase a file, you cannot retrieve it, so be very careful 
when you use wildcards. Generally, DEL does not query you 
before erasing files. However, it does query you when you use 
the asterisk (*) wildcard for both the filename and the 
extension (*.*). For *.* it displays the following prompt: 


Are you sure (Y/N)? 


Type Y to erase all files in the directory; type N to cancel the 
command. 


Command switches 


/C Prompts you to confirm deletion. 
/S Includes system files. 
Example 


This command erases all the .bak files on the current directory 
without querying you. 


A>DEL *.bak 
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DELQ 


Format 


DELQ wildspec [/S] 


Explanation 


The DELQ and ERAQ commands have the same format and 
both erase files. They both query you to make sure you want to 
erase each file. 


DELQ and ERAQ are most useful when used with the wildcard 
characters * and ? to erase an entire class of files. Instead of 
erasing every file that matches the file specification, DELQ and 
ERAQ list the specified files individually, followed by a? 
prompt, to which you respond either with a Y for Yes (erase the 
file) or with an N for No (do not erase the file). 


Command switches 


/S Includes system files. 


Example 


This command gives you the choice to delete each of the .txt 
files in the current directory. 


A>DELQ *.txt 
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DIR 


Format 
DIR [wildspec] [/W|/L][/D|/S|/A] [/N] [/P] [/RI/C] 


Explanation 


DIR displays the contents of a disk directory. DIR with no 
parameters displays all files, other than system or hidden files, 
and all subdirectories in the current drive’s current directory. 
Files with the system attribute are not shown. (See the ATTRIB 
command for a description of attributes.) Subdirectories are 
separated from each other in the command line by a backslash 


Ch 


You can search for a particular file, for example: 
A>DIR myfile.gtm 
DIR will search the current directory for myfile.gtm. If it 
cannot find the file, this message is displayed: 
File not found 


DIR shows the contents of the current drive’s or the designated 
drive’s current directory unless you specify another drive or 
path. 

You can select a file or class of files to display by entering a 
specific or a general file specification using the wildcard 
characters (* and ?). 


The DIR display shows the following information about the 
current directory: 


Drive selected 


C) 


Volume label of current drive 


oO 


Full path used for file search 


CL 


List of file names 


o 


Number of files found 


oO 


Amount of storage space left, in bytes 
Whether any system files were omitted from the display 


Cl 
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The DIR switches can be entered individually, in combination 
and in any order. 


Command switches 


/D Displays files where the system attribute is 
reset. This is a default switch. 


Displays all files with the system attribute set. 
Displays all files. 


Displays only the names of files with 
backslashes (\) before directories. 


Includes size, date, and time; the default. 


Pauses at the end of each full page. The default 
is no paging. 


Allows you to return to the default paging 
switch. 


S82 FP 2ea 


Tells DIR to remember new switches you 
specified as the default switch. 


/C Used with other switches to make them the 


default for the next DIR command issued, for 
example DIR /C /W. 


Examples 


The following command displays all files and subdirectories in 
drive C:’s current directory with the system attribute: 


A>DIR c:/s 


The next command displays all files and subdirectories with the 
bat file extension in drive A:’s current directory. It uses the 
“Long” format, giving information on size, and date and time 
stamping. The display pauses with each full screen. Files with 
the system attribute set are included and the switches 
remembered for the next DIR command without switches. (The 
filespec is not remembered.) 


ADDIR *.bat/I/p/a/r 
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DISKCOMP 


Format 


DISKCOMP [/H] [d: [d:]] [/1] [/8] [/v] 


Explanation 


DISKCOMP compares two entire diskettes track by track. This 
is useful, for example, to check that a DISKCOPY operation has 
worked correctly. 


If you specify DISKCOMP with no drives, DISKCOMP assumes 
the current drive. If you do not specify two drives, for example 
if you type: 


A>DISKCOMP A: 


DISKCOMP prompts you to swap diskettes as necessary. 


You can also use DISKCOMP to verify that an entire diskette 
can be read, by specifying the /V switch. 


Command switches 


/H Display help text. 

/1 Compares only the first side of the diskettes, 
even if the diskettes are double-sided. 

/8 Compares only the first eight sectors per track 


of a diskette, even if the first diskette contains 
more sectors per track. 


/V Verifies that the whole disk can be read. 


If a mismatch is found, DISKCOMP displays a "Compare" error 
message showing the track and side number where the 
mismatch was discovered. 


Remarks 


If you copy all the files from one diskette to another with the 
COPY (rather than DISKCOPY command), DISKCOMP will 
probably return an error, even if the copying is done correctly. 
This is because COPY may place files on a destination diskette 
in a different order from the source diskette. (The way to check 
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that a COPY operation has worked is to use the COPY /V 
switch.) 


DISKCOMP does not work with networked drives or with 
drives affected by a ASSIGN, JOIN or SUBST command. 


The first diskette must be the same type (for example 360 
Kbytes, 1.2 Mbytes) as the second diskette or you get an error 
message. 


Examples 


This command compares the first diskette in drive A: with a 
second diskette in drive A: (you are prompted to change 
diskettes where necessary): 


A> DISKCOMP 


This command compares the diskette in drive A: with the 
diskette in drive B: 


A> DISKCOMP a: b: 
To verify a diskette in drive B: 
A> DISKCOMP b: /v 
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DISKCOPY 


Format 


DISKCOPY [/H] [source_drive] [destination_drive] [/1] 


Explanation 


The DISKCOPY command copies entire diskettes of the same 
format. If the destination disk has a different format, or is 
unformatted, DISKCOPY will format it to match the source 
disk (where this is possible). If you want to copy files between 
diskettes with incompatible formats, use the XCOPY command. 


WARNING 


DISKCOPY only works with diskettes, not with a hard or 
virtual disk. DISKCOPY erases anything that exists 
already on the destination diskette. 


If you omit the destination drive, DISKCOPY copies to the 
default drive, not the source drive. If the source and destination 
drives are identical, DISKCOPY prompts you when you need to 
swap disks. If you omit both drives, DISKCOPY copies to the 
default drive. 


Command switches 


/H Displays help text. 

/1 Causes DISKCOPY to copy only side 0 of a 
diskette, enabling you to copy single-sided 
diskettes. 


Drive and diskette types supported by DISKCOPY 


You need to know your drive and diskette types before you 
attempt a DISKCOPY. Certain disk types cannot be copied in 
certain drive types. Table 8-7 lists the drive types supported by 
DISKCOPY. 
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Table 8-7 Drive types supported by DISKCOPY 


disk size disk type tracks capacity 

5 4" SS/DD 40 18 OKbytes 
5 ys" DS/DD = 40 360 Kbytes 
5 4" DS/HD 80 1.2 Mbytes 
3 YQ" DS/DD 80 720 Kbytes 
3 YQ" DS/HD = 80 1.44 Mbytes 


where diskette types are: 
SS = Single-sided 

DD = Double-density 

DS = Double-sided 

HD = High density 


Remarks 


If you want to copy a complete structure of directories and files 
from one type of disk to another type of disk, you can use the 
XCOPY command. (This will not include a volume label.) 


A180 Kbyte drive can copy 160 and 180 Kbyte diskettes. 


A 360 Kbyte drive can copy 160, 180, 320 and 360 Kbyte 
diskettes. 


A1.2 Mbyte drive can copy 1.2 Mbyte diskettes. It can also copy 
160, 180, 320 and 360 Kbyte diskettes, but you may not be able 
to read these diskettes in a 180 or 360 Kbyte drive. 


A720 Kbyte drive can only copy 720 Kbyte diskettes. 


A 1.44 Mbyte drive can copy 720 Kbytes and 1.44 Mbyte 
diskettes. 
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Example 


If you enter the command: 
A> DISKCOPY a: a: 


DISKCOPY prompts you to insert the source diskette. When 
the information on the source diskette is copied into memory, 
you are prompted to insert the destination diskette. The 
information in memory is then copied onto the destination 
diskette. This may be repeated several times depending on the 
size of the disk. 
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ERAQ 


Format 


ERAQ wildspec [/S] 


Explanation 


The ERAQ and DELQ commands have the same form and each 
erases files and queries you before erasing a file. The ERASE 
command is similar to these commands but in most cases 
erases files without queries. 


ERAQ and DELQ are most useful when used with the wildcard 
characters * and ? to erase an entire class of files. Instead of 
erasing every file that matches the file specification, ERAQ and 
DELQ list the specified files individually, followed by a? 
prompt, to which you respond either with a Y for Yes (erase the 
file) or with an N for No (do not erase the file). 


Command switches 


/S Include system files. 


Example 


This example gives you the choice to delete each of the .bak 
files in the current directory. 


A>ERAQ *.bak 
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ERASE/ERA 


Format 
ERASE wildspec [/C] [/S] 


or 


ERA wildspec [/C] [/S] 


Explanation 


The ERASE and ERA have the same form and each removes 
the specified file or files from the directory. The file 
specification can identify a particular file, or it can indicate a 
group of files through the wildcard characters * and ?. 


After you erase a file, you cannot retrieve it, so you should be 
very careful when you use wildcards. Generally, ERASE does 
NOT query you before erasing files. However, it does query you 
when you use the asterisk (*) wildcard for both the filename 
and the extension (*.*). For *.* it displays the following query: 


Are you sure (Y/N)? 


Type Y to erase all files on the (directory); type N to cancel the 
command. 


Command switches 


/C Prompts you to confirm deletion. 
/S Include system files. 
Example 


This command erases all the .bak files on the current directory, 
without querying you. 


A> ERA *.bak 
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EXE2BIN 


Format 


EXE2BIN [/H] filel[.exl] [file2[.ex2]] [/Sxxxx] 


Explanation 


EXE2BIN is a utility which converts .exe type executable 
program files produced by a DOS Linker into a binary image 
(.bin) or .com executable file. 


EXE2BIN is a utility mainly for use by program developers. 


Files with the extension .exe produced by a DOS Linker have a 
special header which includes a relocation table. The header 
provides DOS with information on the size, memory 
requirements and entry point of a program as well as the 
locations in the program of absolute segment address 
references. Files with the extension .com do not contain this 
special header as they are absolute memory images of the 
program to be executed. Whether the file produced is a .bin or 
.com type file depends on what is set in the initial IP 
(Instruction Pointer) field in the source .exe file header. If the 
IP field contains a value of 100H, a.com file is produced. If the 
IP field contains a value of 0, a .bin file is the result. This is not 
applicable if the destination filename extension (ex2) is 
specified. 


A.exe program must have the following characteristics before 
it can be converted to a .com file: 


1 The program must have a maximum size once loaded of 
65277 bytes. 


2 The program must have its entry point at offset 100H within 
its segment. 


1 The program must not have a stack segment declared. 


1 The program must have no absolute segment address 
references which require segment fixups stored in the .exe 
header. (Segment fixups are needed if the program contains 
instructions requiring segment relocation, which is usually 
done by the DOS loader using the .exe file’s relocation table.) 
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For a .exe program to be converted to a .bin file it must: 
QO have its entry point at absolute offset 0 in its memory usage. 
“i not have a stack segment declared. 


Command switches and syntax 


/H Displays help text. 

filel The path to, and name of, the source .exe file, if 
no extension is specified a default of .exe is 
used. 

file2 The path to, and filename of, the destination file 


to be produced. If file2 is not specified, file1 is 
used with an extension of .com or .bin. If file2 
is specified but without an extension, the source 
file is used with a .com or .bin extension 
depending on the contents of the source .exe 
header. 


/Sxxxx /S followed by four Hexadecimal digits gives the 
base segment value to be used if any segment 
fixups are required for the .bin file. If fixups are 
needed, but this parameter is omitted, you are 
prompted to enter a value. 


Examples 


This command converts the .exe file data.exe to the file 
data.bin, type: 


C> EXE2BIN data 


The following command converts the file utility.tst (which 
includes a valid .exe header and fulfills the requirements for 
conversion to a .com file) to the file result.fin (which will be a 
valid executable file): 


C> EXE2BIN utility.tst result.fin 
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The following command converts the file utility.tst (which 
includes a valid .exe header and fulfills the requirements for 
conversion to a .bin file) to the file abinfil.fin (which will be a 
valid .bin file) using a base segment fixup value of 1234 
hexadecimal: 


C>EXE2BIN utility.tst abinfil.fin /S1234 
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EXIT 


Format 


EXIT 


Explanation 


This command returns you to another program. Some programs 
allow you to leave them, work with DR DOS commands, and 
then return to what you were doing before. EXIT is the 
command you use to return from the DR DOS prompt to the 
program. 

EXIT also stops a secondary COMMAND.COM if one is loaded, 
(see the entry for COMMAND). 
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FASTOPEN 


Format 
FASTOPEN /H 


Use FASTOPEN setting in config.sys 


Explanation 


FASTOPEN reduces the time taken to access files on a hard 
disk which are being repeatedly accessed. It does this by 
remembering the locations of the files on disk, so that DR DOS 
does not have to navigate along the path every time the file is 
opened. 

DR DOS sets up a special table of these filenames in memory 
and you can set the size of this table by inserting a FASTOPEN 
statement in your config.sys file using SETUP. See Chapter 9 
for more information. 


FASTOPEN.EXE is supplied with DR DOS, but does not 
perform any function. It is supplied explicitly for applications 
which require it to exist. 
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FDISK 


Format 


FDISK [/H] [/D] 


Explanation 


FDISK is a menu-driven utility which is used to divide a hard 
disk into partitions. 


Before you can use a hard disk you need to partition it. This 
means to define sections on the disk. The maximum size section 
or partition you can have is 512 Mbyte (you can choose to have 
smaller partitions if you wish). If you are preparing a hard disk 
for the first time you will need to prepare a special DOS 
partition in which to install DR DOS. This is called the primary 
partition, see Create DOS primary partition later in this section. 


Using FDISK you can create one primary DOS partition and 
one extended DOS partition, which may contain as many 
logical disk drives as you require. You can then pass 
information between DOS partitions on a hard disk as if 
between different drives. 

For example, if the disk is divided into a primary partition and 
an extended partition containing two logical drives, you can 
address the partitions as follows: 

) C:is the primary partition. 

O D: is the first logical drive on the extended partition. 
OE: is the second logical drive on the extended partition. 


Command switches 


/H Displays help text. 


/D Allows the deletion of an existing non-DOS 
partition. Use with care! 
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Starting FDISK 


When you type FDISK, the current partition status of the hard 
disk is displayed followed by a Main Menu of options, as in the 
following example: 


FDISK R1i.42 Fixed Disk Maintenance Utility 
Copyright (c) 1986,1988,1994 Digital Research Inc. All rights reserved. 


Partitions on ist hard disk (58.8 Mb, 965 cylinders): 
No Drive Start End NE Status Type 
1 C: 6 963 58.8 A DOS 3.31 


Select options: 

1) Create DOS partition 

2) Delete DOS partition 

3) Select bootable partition 


Enter desired option: (ESC = exit) [?] 


Note 


You only see option 4 if your hard disk contains an extended 
partition, and option 5 if your computer has more than one 
hard disk. 


Press Esc to return to DR DOS from the Main Menu, or to 
return from a chosen option to the Main Menu. 


The current status of the disk 


As mentioned above, beneath the FDISK title line is the current 
partition status of the disk. The different items of information 


shown are: 

No Each partition in the disk is numbered in the 
order in which partitions appear on the disk, 
starting at 1. 

Drive The drive letter assigned to the hard disk drive, 


starting with C. 
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Start The starting cylinder number for the partition. 
End The ending cylinder number for the partition. 
MB The size of the partition in Mbytes. 

Status Hither A or N. A indicates that the partition is 


active, that is bootable (your computer attempts 
to boot from this partition if started from the 
hard disk). N means not active. 


Type The format of the partition. This can be DOS 
(for example DR DOS, Concurrent DOS or 
another DOS operating system) or non-DOS. 


The options you can select from the Main Menu are described 
below. 


Option 1, Create DOS partition 


Select this option if you are: 

) Preparing a hard disk for the first time. 

4) Adding a new partition to a hard disk. 

FDISK warns you if there is not enough space to create a new 
partition or if all partitions are already in use. 

When you select this option, you are asked which type of 
partition you want to create: 


Select options: 

1) Create DOS primary partition 

2) Create DOS extended partition 

3) Create logical drive in extended partition 


Enter desired option: (ESC = exit) [?] 


Remarks 

€) You can create a primary partition only when you format a 
hard disk for the first time and no primary partition already 
exists on the disk. 


‘1 You can create an extended partition only if a primary 
partition already exists on the disk. 


() You can create a logical drive only if you have an extended 
partition. 


CL 


A warning message is displayed if you make an invalid 
selection. 
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1) Create DOS primary partition 


When you select this option you are asked if you want to use 
the largest available space on the hard disk (this example is for 
a 40.2 Mbyte drive): 


Use cylinders 1 - 975 for DOS (40.2 MB) (Y/N)? 


If you want to use all the available space, type Y to accept the 
default selection and press Enter. 


If you do not want to use all the available space (for example if 
you want to have an additional operating system), type N and 
press Enter. 


Note 


If you plan to add another operating system to the hard disk, 
check the size requirements for that system before you allocate 
space to DOS. 


You are then prompted for the starting and ending cylinders: 
[Enter] starting cylinder: 

[Enter] ending cylinder: 

You need at least 20 cylinders to run DR DOS. 


If FDISK encounters a defective track on the system area of the 
disk, it does not create a partition. FDISK prompts you to try 
again with another starting cylinder number. Similarly, if there 
is insufficient space at a cylinder, FDISK prompts you to try 
another cylinder number. 


You are prompted to: 
[Enter] disk label: 
You can give the partition a label of up to eleven characters. 


Once you have chosen your partition size you are returned to 
the Main Menu. The screen displays details of the new 
partition you have created. Press Esc to leave the FDISK 
program. 


The partitions you create contain no program or data files so 
you must load the files you want into the appropriate partition. 
For example, you may want to load DR DOS into a partition so 
that you can boot the system from the hard disk. If you are 
using FDISK as part of the DR DOS installation procedure, the 
INSTALL program automatically does this for you. So when 
you have chosen your partition size and you are asked to 
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reboot, simply leave your DR DOS diskette in drive A: to restart 
the INSTALL program. 


You can use INSTALL to load DR DOS into your partition or 
you can switch to drive A: and use the SYS command. Then use 
option 3 Select bootable partition (described in this section) to 
make the partition active. 


2) Create DOS extended partition 


Select this option if you already have a DOS primary partition 
and want to add another partition to your disk. You are asked 
to specify the starting and ending cylinders for the partition, in 
the same way as creating a DOS primary partition. You are 
then returned to the Main Menu and the screen displays details 
of the partition you have just created. 


Note 


You cannot use an extended partition until you have created 
one or more logical drives within it. The extended partition is 
not assigned a drive letter of its own. 


3) Create logical drive in extended partition 


Choose this option to create a logical drive in an existing 
extended partition. When you select it the screen displays the 
current status of the extended partition: 


Logical drives in extended partition (8.2 Mbyte, 195 cylinders): 


No 
1 


Drive Start End MB Type 


are 785 0.6 DOS 2.0 


You are then asked to specify the starting and ending cylinders 
for the logical drive. All logical drives must be contained 
completely within the extended partition. When the drive has 
been created you are offered the choice of creating another 
logical drive or returning to the Main Menu. Press Ese to 
return to the Main Menu. 
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Option 2, Delete DOS partition 


WARNING 


Select this option to delete a current partition. 


When a partition is deleted, you can no longer access data 
in that partition, so use this option with care. Back up first 
all files held in the partition (either on diskettes or in 
another partition on the hard disk). 


When you select this option, you are asked which type of 
partition you wish to delete: 


Select option: 

1) Delete DOS primary partition 

2) Delete DOS extended partition 

3) Delete logical drive in extended partition 


Enter desired option: (ESC = exit) [?] 


You can only choose option 2 to delete an extended partition if 
the partition does not contain any logical drives. If the partition 
you want to delete contains logical drives you must delete them 
first. 


If you select option 1 or option 2 you are prompted to: 
Enter number of partition to delete (ESC=exit) 


Type in the number of the partition you want to delete and 
press ENTER, you will see: 


Do you really want to erase all data (Y/N)?... 
If you are ready to delete the partition, type Y and press Enter. 


If you select option 3 the screen displays the logical drives in 
the extended partition before prompting you to select a drive to 
delete. 


Deleting a non-DOS partition 


To delete an existing non-DOS partition, type FDISK /D at the 
command line to start the FDISK utility in the normal way. 
The procedure is then the same as for deleting a DOS partition. 


If you do not specify /D at the command line, you are not 
allowed to delete a non-DOS partition. 
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Option 3, Select bootable partition 


Use option 3 to select which partition on a hard disk is to be 
active. This is the partition containing the operating system 
and files you want to access when you switch on your computer. 
If you designate a particular partition as active, your computer 
searches this partition if DR DOS (that is the computer) is 
booted from the hard disk. Only one partition can be active at a 
time. 


When you select this option, you are prompted to: 
Select partition to make bootable......... 


Type in the number of the partition you want to make active 
and press Enter. 


Note 


If your hard disk contains only DR DOS partitions then only 
the primary partition can be made active. If you try to select an 
extended DR DOS partition you will get an error message. 


This partition now has an active status (A). The partition that 
was previously active is now non-active (status N). 


Your computer will always try to load an operating system from 
drive A:. If there is no diskette in drive A: or if drive A: is not 
working, the computer tries to load an operating system from 
the active partition on the hard disk. 
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Option 4, Display logical drives in extended partition 


You only see this option in the Main Menu if you have an 
extended partition on your disk. If you select it the screen 
displays the current status of the logical drives in your 
extended partition, for example: 


Logical drives in extended partition (8.5Mb, 205 cylinders): 
No Drive Start End MB Type (i.e no status) 
1 D 771 975 8.4 DOS 2.0 


Option 5, Select alternate fixed disk 


You only see this option in the Main Menu if you have multiple 
hard disks on your computer. Select it to switch from one disk 


to another. The screen displays the current partition status of 
the disk as follows: 


Partitions on 2nd hard disk (20.3 MB, 614 cylinders): 


No Drive Start End MB Status Type 
1 Bs z 304 10.1 A DOSs:*3.'0 
2 = 305 613 L052 N (other) 


The options displayed are the same for both disks. 
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FILELINK 


Format 


FILELINK [/H] command [@][(wildspec] [wildspec2] 
[comparm] [/switches] 


Explanation 


FILELINK is a utility used to transfer files between two 
computers connected by their serial communication ports. This 
can be useful when you are not able to transfer files via 
diskettes, perhaps because one computer has a diskette-drive of 
a different type from the other, or does not have a 
diskette-drive at all. 


You can also use it to look at a directory of files on another 
computer. FILELINK must be running on both computers in 
order to transfer files or produce a directory listing; a useful 
feature of the utility is that you can install it from one 
computer to the other using the serial communications port. 


FILELINK operates in two different modes: master and slave. 
When FILELINK is running in slave mode, it only acts in 
response to requests received from the other computer running 
in master mode across the serial communication line, usually to 
send or receive files. 
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Command options 


/H Displays help text. 


command FILELINK command (the valid abbreviation is 
shown in brackets): 


DIRECTORY (DIR) 
DUPLICATE (DUP) 
QUIT (QUI) 
RECEIVE (REC) 
SETUP (SET) 
SLAVE (SLA) 
TRANSMIT (TRA) 


[@]wildspec The drive, path and name of the file to be 
copied. Files are renamed if a destination 
filename is specified. If wildspec is preceded by 
@, it specifies the drive, path, and name of a file 
that contains a list of the files to be copied. 


wildspec2 The destination drive, path, and name of the file. 


comparm The communications port and baud rate to be 
used, in the form COM#:baud rate, where # is 
the COM port number (for example 1 or 2), and 
baud rate can be for example, 9600 or 19200 
depending on your own computer. 


/switches See the separate switch description under each 
FILELINK command. 


Before using FILELINK a suitable cable must connect your two 
computers, see the section Cabling information at the end of 
the FILELINK description. 


Note 


To avoid confusion when we discuss FILELINK, the computer 
you are typing a command on is referred to as the master 
computer, and the computer connected to it via the serial cable 
is the slave computer. FILELINK commands are entered at the 
command line on the master computer. 
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Using FILELINK 
Setting the default communications port (SETUP) 


You can set a default communications port to be used when 
FILELINK is invoked without a communications port specified 
in the command line. To do this use the FILELINK command 
SETUP in the form: 


FILELINK SETUP comparm 


where: 


comparm is the communications port and maximum baud rate 
to be used. 


(SETUP may be abbreviated to SET) 


If you do not set up the default communications port, you will 
have to remember to specify it each time you issue a FILELINK 
command. 


Typing FILELINK SETUP without any parameters displays 
the current setup. 


About baud rates 


In a serial communication link, information is transferred one 
bit after another. The number of bits transferred per second is 
referred to as the baud rate. Due to various standard serial 
transfer protocols, only 8 bits of data are transferred for every 
10 bits of information. So at 9600 baud, up to 960 bytes can be 
transferred every second. The higher the baud rate, the quicker 
your files are transferred. FILELINK supports up to 115,200 
baud, although not every computer can work at this speed. You 
may want to start working with FILELINK with a baud rate of 
9600 which most computers should accept. Then when you have 
successfully transferred files using FILELINK, and you know 
that your serial ports and cable are correct, you can experiment 
with higher baud rates. 


Whichever baud rate you use, it must be the same on each 
computer. 


There are various standard baud rates available; they are listed 
in Table 8-8 with their valid abbreviations. 
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Table 8-8 Standard baud rates 


Abbr. baud rate 


115 115, 200 
56 56, 700 
38 38, 400 
19 19, 200 
96 9, 600 
48 4, 800 
24 2, 400 
12 1, 200 
60 600 
30 300 
15 150 
11 110 


Note 


You may find it convenient to set up the default 
communications port as the same on both computers. The baud 
rate must be the same. 


Examples 


The following command sets a default communications port on 
the master computer to COM1 and the maximum baud rate to 
9600 baud: 


C>FILELINK SET com1: 9600 


The following command displays the current setup: 
C>FILELINK setup 


Current FileLink setup is for: coml:9600 
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Installing FILELINK on a slave computer (DUPLICATE) 
To install FILELINK on a slave computer via a serial link, use 
the FILELINK command DUPLICATE in the form: 


FILELINK DUPLICATE [comparm] 


where: 


comparm is the communications port to be used on the master 
computer. If it is not specified, the default communications port 
is used. 


(DUPLICATE may be abbreviated to DUP) 


You are prompted to carry out various operations on the slave 
computer to install FILELINK. 


Examples 


The following command copies the FILELINK program via the 
serial communications port to a slave computer. As no comparm 
is supplied, the default set by the FILELINK SETUP command 
is used. 


C>FILELINK DUP 


Putting a computer into slave mode (SLAVE) 


To put a computer into slave mode, use the FILELINK 
command SLAVE in the form: 


FILELINK SLAVE [comparm] [/X] 


(SLAVE may be abbreviated to SLA) 


Files cannot be transferred to or from a computer until the 
FILELINK SLAVE command is issued on the slave computer. If 
you do not specify a communications port, the default 
communications port is used. The current directory and drive 
when slave mode is entered becomes the default for files sent 
to, or received from, the slave computer. 


The valid option you can use with this command is: 


[x If you specify /X on the command line no files 
are overwritten on the slave computer. 
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Examples 


The following command puts a computer into slave mode. As no 
comparm is given, the default is used as set by the FL SETUP 
command: 


C:\JESS>FILELINK SLA 


Note that as SLAVE mode was entered when the current drive 
was C: and the current directory was jess, these will be the 
default drive and directory for the slave computer. 


To quit FILELINK running in slave mode, press Ctrl+C, see 
also Quitting FILELINK on a slave computer. 


Sending files to a slave computer (TRANSMIT) 


To send a file or files from the master computer to the slave 
computer, use the FILELINK TRANSMIT command in the 
form: 


FILELINK TRANSMIT [@]wildspecl [wildspec2] [comparm] 
[/A] [/D:dd:mm:yy] [/H] [/™] [/P] {[/R] {[/S] [/U] 
where: 


wildspec! is the drive, path and name of the file to be sent from 
the master computer. 


wildspec2 is the destination filespec on the slave computer. 
(TRANSMIT may be abbreviated to TRA) 


Before you can send files, the slave computer must be running 
in slave mode, see Putting a computer into slave mode. 


The valid options you can use with this command are: 


/A Copy only files with the archive attribute. 
/D:date Only copy files modified since a specified date. 
/H Copy files with hidden or system attributes. 
/M Copy only those files that have their archive 


attribute set and either do not exist on the 
destination or exist but with their archive 
attribute reset. 


When you specify the /M switch, you ask 
FILELINK to copy only those files that you 
have modified on the source directory, but have 
not modified on the destination directory. This 
makes use of the fact that DR DOS 
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automatically sets the archive attribute on any 
file that gets created or changed. You can use 
this switch to regularly back up files from one 
computer to another, see Examples below. 


/P Prompt before copying each file. 

/R Overwrite read-only files on the destination. 
/S Copy files in subdirectories. 

/U Copy only files that do not exist on the 


destination, or that exist but are older versions, 
that is, have an earlier date stamp. 


Examples 


All the following examples assume that the FILELINK SLAVE 
command was issued first on the slave computer, as in the 
example under Putting a computer into slave mode. 


If you have several documents with the file extension .doc, and 
you occasionally alter one or two of them, when you back them 
up you can copy them to the slave computer using the command: 


C>FILELINK TRA *.doc 


However because you know that most of the files are already on 
the slave computer from the last time you backed up, it takes 
less time if you use the /M switch, then only those files you 
have changed since the last backup are copied; the command 
you use is: 


C>FILELINK TRA *.doc /m 
The following command copies all files in the current directory 


of the master computer (c:\mary) to the current directory of 
the slave computer (e:\jess). 


C: \MARY>FILELINK TRANSMIT *.* 


The following command copies all the files in the e:\tools 
subdirectory and all files in the subdirectories below e:\tools to 
the current directory on the slave computer’s A: drive: 


C>FILELINK TRA \tools a: /s 
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Getting files from a slave computer (RECEIVE) 


To receive files from a slave computer (which must be running 
in slave mode), use the FILELINK command RECEIVE in the 
form: 

FILELINK RECEIVE [@]wildspecl [wildspec2] [comparm] 
[/A] [/D:dd:mm:yy] [/H] [(/M] [/P] [/R] [/S] [/U] 


where: 


wildspec! is the drive, path and name of the file to be received 
from the slave computer. If wildspec1 is preceded by @, it 
specifies the drive, path, and name of a file that contains a list 
of the files to be received. 


wildspec?2 is the destination wildspec on the master computer. 
(RECEIVE may be abbreviated to REC) 


If you do not specify a communications port, the default 
communications port is used as set up by the FILELINK 
SETUP command. The valid options you can specifiy are the 
same as those described under Sending files to a slave 
computer. 


Examples 


Note that the first command example assumes that the 
FILELINK SLAVE command was issued on the slave computer 
as in the example under Putting a computer into slave mode. 


This command copies all files on the current drive and directory 
of the slave computer (c:\jess), onto the current drive and 
directory of the master computer (e:\jane): 


Cc: \JANE>FILELINK RECEIVE *.* 


The next command copies all files with the extension .doc in 
the current directory of the A: drive on the slave computer, to 
the directory e:\letters on the master computer: 


C>FILELINK RECEIVE a:*.doc c:\letters 
The following command copies all documents modified since 


May 1st 1990 in the directory ¢:\profits on the slave computer, 
to the directory c:\sales on the master computer: 


C>FILELINK REC c:\profits c:\sales /d:5-1-90 


Note in this example the date is in the US format, how you 
enter the date depends on how your computer is set up. Enter 
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the DR DOS DATE command on its own to see what your date 
format should be. 


Displaying a list of files on a slave computer (DIRECTORY) 


To display a directory of files on a slave computer (which must 
be running in slave mode), use the FILELINK command 
DIRECTORY in the form: 


FILELINK DIRECTORY [filespec] [comparm] [/A] 
[/Dixdated.(/H). (/PI: (/S] 
(DIRECTORY may be abbreviated to DIR) 


If you do not give a communications port, the default port is 
used (as set up by the FILELINK SETUP command). 


The valid switches are: 


/A Show only files with the archive attribute. 
/D:date Show only files modified since the specified date. 
/H Show files with hidden or system attributes. 

/S Show files in subdirectories. 

/P Pauses after each screenful of display. 

Examples 


The following command displays a directory of all files of the 
current directory of the current drive on the slave computer: 


C>FILELINK DIR 


The following command displays a directory of all files with the 
extension .bat in the current directory of the current drive on 
the slave computer: 


C>FILELINK DIR *.bat 


The following command displays a directory of all files with the 
extension .bat dated 1-1-90 or later, in the root directory of 
drive A: on the slave computer. 


C>FILELINK DIR a:\*.bat /d:1-1-90 


The following command displays a directory of all files with in 
the current directory of drive C: on the slave computer. 


C>FILELINK DIR c: 
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Quitting FILELINK on a slave computer (QUIT) 


To stop running FILELINK (in slave mode) on a slave 
computer, either press Ctrl+C at the slave computer’s 
keyboard, or use the FILELINK command QUIT from the 
master computer in the form: 


FILELINK QUIT [comparm] 


where: 


comparm is the communications port on the master computer, 
if one is not given the default is used as set up by the 
FILELINK SETUP command. 


(QUIT may be abbreviated to QUI) 
Examples 


The following command stops FILELINK running on a slave 
computer via the communications port com2: 


C>FILELINK QUI com2 


188 FILELINK 


Cabling information 


The type of cable you need for FILELINK is an RS232 Null 
Modem cable. The cable must have connectors that are 
appropriate to the computers to be linked. Normally your 
computers will have either 9-pin, or 25-pin D-type male 
connectors for their serial ports. Therefore the cable to connect 
them must have 9 or 25-pin (as appropriate) D-type female 
connectors, see Table 8-9. 


Table 8-9 Serial cable pin connections 


25 pin to 25 pin 9 pin to 9 pin 
7 Ground 5 Ground 
2 Transmit data 


wr, Receive data 


7 5 
2 3 Transmit data 
3 2 
4 4 Requesttosend 7 
5 a, 5 Clear to send 8 
6 6 

4 


3 

2 Receive data 

7 Request to send 
8 Clear to send 
6 

4 


XXX 


a ab Data set ready Data set ready 
20 20 Data terminal Data terminal 
ready ready 


9 pin to 25 pin 
5 7 Ground 

3 oa 2 Transmit data 
2 3 Receive data 
i 4 Request to send 
8 Pe 5 Clear to send 
6 6 Data set ready 
_ « 


20 Data terminal 
ready 
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FIND 


Format 


FIND [/H] [/B] [/C1][/F] [/N] [/S]{/U][/V] “search string” 
[@]wildspec[...] 


Explanation 


FIND searches for a string of characters in a group of text files 
and displays the lines containing the search string. The search 
string must be enclosed in double quotes (""). If the string 
includes double quotes, you must include an extra pair (that is 
“find this""). 


Multiple files may be specified on the command line using the 
wildcard characters ? and *. 


If no files are specified FIND reads from standard input 
(usually the keyboard or a redirected file). 


Command switches 


/H Displays help text. 


/B Changes display format of the list that is 
produced, so it shows a series of headings with 
the matches listed beneath. 


/C Shows only the total number of lines that 
contained the string. 


/F Shows only the names of those files that contain 
the “string”. 
Displays line numbers. 


/S Searches files in subdirectories that are derived 
from the current directory. 


/U Case-sensitive search (for example “A” doesn’t 
match “a”). 


IV Displays the lines not containing the string. 
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Examples 


The following command calculates the number of lines 
containing the word sorry in each of the three files 
apology1.let, apology2.let and apology3.let: 


A>find /C “sorry” apology1.let apology2.let apology3.let 


The following command displays all the subdirectories listed in 
the current directory. FIND acts as a filter, receiving input from 
the DIR command and displaying as output only those files that 
contain the string: 


A>DIR | find “<DIR>” 
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FORMAT 


Format 


FORMAT [/H] d: [/S] [/V] [/1] [/41] [/81] [/B] [/T:nn] 
{/N:n] [/F:nnnn] 


Explanation 


The FORMAT command formats diskettes into standard 
formats. (Use FDISK to format hard disks.) The default format 
for a diskette depends on the drive type, for example the 
default format for a 360Kbtye diskette drive is a 360Kbyte 
diskette. This default can be changed by using some of the 
FORMAT switches. 


WARNING FORMAT will wipe everything off the diskette. Use it with 
great care. 


FORMAT supports the drive types shown in Table 8-10. 


Table 8-10 Drive types supported by FORMAT 


disk size disk type tracks capacity 

5 4" SS/DD 40 180 Kbytes 
5 4" DS/DD 40 360 Kbytes 
5 4" DS/HD 80 1.2 Mbytes 
3" DS/DD 80 720 Kbytes 
3 YY" DS/HD 80 1.44 Mbytes 
where diskette types are: 


SS = Single-sided 
DD = Double-density 
DS = Double-sided 
HD = High density 
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Command switches 


/A 
/S 


/1 


/4 


/8 


Displays help text. 


Copies DR DOS system files onto the formatted 
disk, giving the names of files copied. This 
switch can’t be used with 160 and 180 Kbytes 
disks because of their limited capacity. DR DOS 
first looks in the root directory of the disk in the 
current default drive for the system files and 
uses COMSPEC to find COMMAND.COM. If 
they cannot be found, DR DOS prompts you to 
insert a diskette containing the system files in 
the FORMAT drive. After reading the system 
files, DR DOS prompts you to remove the 
diskette and insert the diskette to be formatted. 


Specify the volume label to use on the disk. The 
volume label can be up to 11 characters in 
length. 


Forces single sided formats on a double sided 
drive. (Only allowed on 5 Y4" drives.) To use /1 
you must use either /4 or /F:360 first to instruct 
your diskette-drive that the diskette to be 
formatted is 360 Kbytes. 


Forces 360 Kbytes format. Use this to format 
360 Kbytes format diskettes in a 1.2 Mbyte 
format drive. Note that diskettes formatted this 
way cannot be reliably read by 360 Kbytes 
drives. This has the same effect as /N:9 /T:40. 


Formats 9 sectors but uses only 8 (only allowed 
on 5 4" drives). The default is to format 9 
sectors and use all 9. To use /8 you must use 
either /4 or /F:360 first to instruct your 
diskette-drive that the diskette to be formatted 
is 360 Kbytes. 


Formats 9 sectors but uses only 8. Reserves 
space for DOS system files. (Only allowed on 
5 4" drives.) 
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The capacity of the drive to be formatted. Use 
this switch when the format required is other 


As an alternative to the /F:nnnn switch, you can 
use the /T: and /N: switches to specify the 


Sets tracks to 80 used in conjunction with /N:9. 
Forces a 40 track diskette to be formatted. (Only 


Forces 9 sectors per track. (Allowed on 3 4" 
1.44 Mbyte drives or 5 1/4" 1.2 Mbyte drives in 


Forces 8 sectors per track (on 1.2 Mbyte drives 


/F:nnnn 
than the default for the drive. 
Values can be: 
For 5 14" diskettes For 314" diskettes 
160 - 160 Kbytes 720 - 720 Kbytes 
180-180 Kbytes 1440- 1.44 Mbytes 
320 - 320 Kbytes 
360 - 360 Kbytes 
1200 - 1.2 Mbytes 
diskette type: 
/T:80 
/T:40 
allowed on 5 14" 1.2 Mbyte drives.) 
/N:9 
conjunction with /T:80 or /T:40.) 
/N:8 
in conjunction with /T:80). 
Remarks 


FORMAT does not recognize drive assignments made with the 
ASSIGN command. 


You cannot format drives over a network. 
Do not use FORMAT with a JOIN or SUBST command. 
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Examples 


To format a diskette: 
On a hard disk system with one diskette drive, insert a 
blank diskette into drive A: and type: 


C>FORMAT A: 


You are prompted: 


Insert diskette to format in drive A: 
and strike a key when ready 


Press Enter. A message appears showing the progress of 
the formatting. When formatting is complete, you are 
prompted: 

Format another diskette (Y/N)? 


Press Y to format another diskette and insert a blank 
diskette into drive A: and follow the procedure through 
again. Otherwise type N. 


On a twin-diskette system, with your system diskette in drive 
A: type: 
A>FORMAT B: 


and place the diskette to be formatted in drive B:. 


To format a diskette at 360 Kbytes with the diskette in a 
1.2 Mbyte drive: 


A> FORMAT A: /F:360 


a ERAFTABL 198 


GRAFTABL 


Format 


GRAFTABL [/H] [nnn] [/STATUS] 


Explanation 


GRAFTABL enables you to display extra and international 
characters (ASCII characters 128 through 255) when you have 
a color/graphics (CGA) adapter fitted to your computer. 
GRAFTABL only needs to be loaded once during each DR DOS 
session, so you may want to include it in your autoexec.bat 
file (you can use the SETUP program to do this). 


Command switches 


/H Displays help text. 


nnn is the number of one of the following character 
sets: 


437 USA (the default if no code is supplied) 
865 Norway 

860 Portugal 

863 French Canadian 

850 Multilingual 


/STATUS Displays the currently selected country code 
page. 


Remarks 


GRAFTABL adds to the amount of space in memory taken up 
by DR DOS. 


Example 
When you type: 
C>GRAFTABL 


you see a message like this: 


Character table for USA has been loaded. 
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GRAPHICS 


Format 


GRAPHICS [/H] [COLOR] [/R] 


Explanation 


GRAPHICS allows you to use the PrtSc key to print a graphics 
display onto an IBM-compatible graphics printer. GRAPHICS 
only needs to be loaded once during a DR DOS session, so you 
may like to include it in your autoexec.bat file. 


Command switches 


/H Displays help text. 


COLOR Enables graphics to produce color output on an 
IBM-compatible color graphics printer, 
producing eight colors. 


/R Prints black and white exactly as they appear 
on your display. The default is to print what is 
white on your screen as black on the printer. 


Remarks 


GRAPHICS increases the amount of memory space occupied by 
DR DOS. 
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HILOAD 


Format 


HILOAD filespec 


Explanation 


The HILOAD command is used to load programs into upper 
memory. This leaves more space for your other applications and 
data in conventional memory. Generally you should load TSR 
(Terminate-Stay-Resident) programs into upper memory. TSRs 
are memory-resident programs, that is programs that are not 
unloaded from memory when they finish execution, so they do 
not need to be loaded from disk each time they are executed. 
Before HILOAD can be used, a device driver supporting upper 
memory must be loaded, see Chapter 9. 

You can load the following DR DOS programs using HILOAD: 
CURSOR .EXE 

KEYB. COM 

NLSFUNC.EXE 

GRAPHICS.COM 

GRAFTABL.COM 

JOIN. EXE 

SHARE. EXE 


Remarks 
Programs will be loaded into conventional memory, if there is 
not enough upper memory available, see also Appendix C. 


HILOAD is very useful for loading network drivers, device 
drivers and TSRs. 


Not all applications can be loaded using HILOAD. 
HILOAD can be placed in your autoexec.bat file so programs 
for example, can be loaded into upper memory at startup. 


Examples 


The following command loads the KEYB program into upper 
memory. 


C>HILOAD KEYB.COM UK 
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JOIN 


Format 
JOIN [/H] [drivel: drive2:path] 


JOIN dirpath /D 


Explanation 


Using JOIN you can attach the directory structure of one disk 
drive to an empty subdirectory of another disks drive. Doing 
this makes the directory structure of the first drive (and all its 
files) appear to be a subdirectory of the directory you specified 
on the second drive. Connecting drives using JOIN means you 
can use commands like TREE and XDIR on joined drives as if 
they were one large drive. 


Command switches and syntax 


/A Displays help text. 

drivel The drive to be joined to the subdirectory of 
another drive. 

drive2 The drive and directory used to refer to files on 
drive 1. 

/D Cancels a JOIN command. 


If you give a path on the second drive that does not exist, DR 
DOS tries to make a directory with that path. If the directory at 
the end of the path on the second drive already exists, it must 
be empty. After you have issued a JOIN command, the first 
drive is no longer available to you and if you try to access it you 
get an error message. 


You can only connect drives using JOIN to a directory leading 
from the root directory. Note that all subdirectories below the 
joined directory are not accessible until you disconnect them. 


To cancel an existing JOIN command, type JOIN and the first 
drive followed by the /D switch. Always remember to do this 
when you have finished working. 


To see a list of joined drives, type JOIN on its own. 


8: JOIN 199 


Caution You must not use the following commands on drives 
connected with JOIN: 


ASSIGN 
BACKUP 
DISKCOPY 
DISKCOMP 
FORMAT 
RESTORE 
SUBST 


Also drives connected using JOIN do not work on 
networked drives. 


Examples 
This command connects drive A: to subdirectory \clients: 


C>JOIN a: c:\clients 


Now drive A: can be accessed via e:\clients. If you try to access 
drive A: directly you get this error message: 


Invalid drive 


The following command displays the connected drive: 
C>JOIN 


A: => C:\CLIENTS 


The following command cancels a JOIN command: 


C>JOIN a: /d 
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KEYB 


Format 
KEYB [/H] xx[+/-][,codepage] 
Explanation 


This command loads the keyboard program which makes 
characters displayed on the screen match those typed at the 
keyboard. You need to use KEYB each time you start DR DOS if 
you do not have the default (US) keyboard. If the KEYB 
command is part of the autoexec.bat file, it is loaded 
automatically each time DR DOS is started. This is set up for 
you when you install DR DOS. 


Command switches and syntax 


/A Displays help text. 

xx A two letter country code, as shown in Table 
8-11. 

+ Forces the keyboard program to assume an 


enhanced(101/102/104 key) keyboard. 


KEYB usually recognizes enhanced keyboards 
automatically. However, if KEYB does not 
recognize your enhanced keyboard, and you find 
that certain keys do not match the characters 
displayed, try re-issuing the KEYB command 
with the + option. 


“ Forces the keyboard program to assume a 
standard (83/84 key) keyboard. 


,codepage Specifies the code page that you want to use. If 
this is missing, the country’s default code page 
is selected. 


It allows the accented characters defined in the 
selected code page to be produced. Some 
characters can only be entered using “dead” key 
combinations. (Dead keys are keys that do not 
display a character when used on their own, but 
if followed by a letter, displays that letter with 
an accent.) To produce the character, first type 
the accent and then press the alphabetical key. 
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To display the accent on its own, type the accent 
and then the space bar. For more information on 
which accented characters are allowed in which 

code page, see Appendix B. 


Table 8-11 Country codes and code pages 


Country Abbreviation Code pages 
Belgium BE 437 850 
Canada (French) CF 863 850 
Denmark DK 865 850 
Finland SU 437 850 
France FR 437 850 
Germany GR 437 850 
Italy IT 437 850 
Latin America LA 437 850 
Netherlands NL 487 850 
Norway NO 865 850 
Portugal PO 860 850 
Spain SP 437 850 
Sweden SV 437 850 
Swiss (French) SF 437 850 
Swiss (German) SG 437 850 
United Kingdom UK 437 850 
United States* US 437 850 
* default 

Remarks 


If you wish to change keyboards while the program is running, 
instead of re-issuing the KEYB command you can switch back 
to the default (USA) keyboard by holding down the Ctrl and 
Alt keys and pressing F1. To go back to your chosen national 
keyboard, type Ctrl+Alt and then F2. 


For more information on code page switching see Chapter 10. 
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Examples 
The following command loads the United Kingdom keyboard. 
A>KEYB uk 


The following command loads the Spanish keyboard and 
ensures that KEYB recognizes the keyboard as being an 
enhanced keyboard. It also ensures that codes for use with code 
page 850 are generated. 


A>KEYB sp+,850 


This command specifies a Norwegian enhanced keyboard, and 
the national code page table 865. 


A>KEYB no+,865 
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LABEL 


Format 
LABEL [/H] [d: label] 


or to delete a volume label: 


LABEL [d:] 


Explanation 


The LABEL command allows you to create, modify or delete the 
volume label on a DR DOS disk or diskette. A volume label is a 
name given to a d‘isk to identify it and is displayed when you 
perform a DIR, TREE or CHKDSK command. Note you can 
also use the VOL command to find out if a disk or diskette has 
a volume label. 

Up to 11 characters are allowed in a volume label. You can also 


use spaces, but not tabs. As with naming files and directories, 
do not include the following characters: 


<>=,3:."? []0)/\4 


If no drive is specified in the command line, the default drive is 
used. You are prompted to type a label if you do not specify one 
at the command line. 


WARNING When you enter a new label it overwrites an existing label 
without giving any warning. 


To delete a label, type LABEL and the disk drive where you 
want the label deleted from. 


Command switches 


/H Displays help text. 


Remarks 


LABEL does not work with drives affected by a SUBST or 
JOIN command. 


You cannot use LABEL on a networked drive. 
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Examples 


This command assigns the name workdisk to the disk in drive 
B 


A>LABEL b:workdisk 
To delete a volume label on drive B: type 
A>LABEL b: 


you get a message similar to this: 


Volume in drive B: is WORKDISK 
Enter Volume label (0 to 11 characters): 


Press Enter and you see this message: 
Delete current volume label (Y/N)? 


Type Y to delete the label. 
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MEM 


Format 
MEM [/H] [/B][/D] [/S] [/P] [/M] [/A] 


Explanation 


The MEM command displays a range of information on the way 
memory is used. If you type MEM on its own, you get a report 
listing how much conventional and extended memory (if your 
computer has memory above 1 Mbyte), your computer has 
allocated. 


The various switches cause additional information to be 
displayed. Most users will find the /B switch useful as it 
explains, amongst other things, where programs are located in 
memory. The remaining options are primarily for advanced 
users, or system programmers. 


Command switches 


/H Displays help text. 


/B Displays areas of memory used by different 
parts of the operating system, such as device 
drivers and BIOS, also the DOS Memory 
Control Block (MCB) chain which shows how 
memory is currently allocated to programs. 


/D Shows the names of all built-in, and loadable 
device drivers, and their location in memory. 
/S Displays the DOS disk buffer chain. For 


conciseness, only groups of buffers with the 
number of buffers is given. 


Pauses at every screenful of information. 


/P 

/M Displays graphically the location of RAM, ROM, 
and EMS memory. This can be useful when used 
to fine tune the installable device driver 
EMM3886.S8YS, see also Chapter 9. 


JA Shows all information (a combination of all the 
above switches). 
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Examples 


The following command displays a report on conventional and 
extended memory only. 


C> MEM 


You see a display similar to this: 


655,360 bytes, ( 640K), conventional memory 
630,080 bytes, ( 615K), largest available block 


4,194,304 bytes (4096K), extended memory 
4,194,304 bytes (4096K), extended memory used 
QO bytes ( OK), extended memory available 
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MKDIR/MD 


Format 


MKDIR | MD [d:]dirpath 


Explanation 


Use MKDIR to create subdirectories in the root directory or 
other subdirectories. You can abbreviate MKDIR to MD. 


If you do not include a backslash (\) before the first 
subdirectory name in the directory path, MKDIR begins the 
path to your new directory from the current directory of the 
current or specified drive. If you do include the backslash, 
MKDIR begins the path at the root directory of the current or 
specified drive. For example if you are in the root directory and 
you want to create the subdirectory hank in the subdirectory 
sales, type: 


A>MKDIR \sales\hank 


If you are currently in the sales subdirectory and want to 
create the subdirectory hank from sales, type: 


A>MKDIR hank 


The path from the current directory leading to the new 
subdirectory must be entered and all the subdirectories in the 
path must exist. If a subdirectory is specified that does not 
exist, MKDIR displays the following message: 


Path not found 


The maximum number of characters in a path to directory 
(including backslashes) is 63. 


When a directory is created, DR DOS automatically adds two 
entries . and .. which it uses as markers to locate and identify 
the directory; these entries cannot be deleted. Files created in a 
directory must be unique within it, but you can create files with 
the same name in another directory. 
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Example 


Use subdirectories to organize your data and command files 
into logical groups. The sequence of MKDIR commands shown 
below creates the hierarchical series of subdirectories shown in 
the chart: 


C>MKDIR \sales 
C>MKDIR\sales\hank 
C>MKDIR\sales\mary 
C>MKDIR\sales\mary\orders 


C>MKDIR\sales\mary\letters 


C>MKDIR\sales\hank\orders 
C>MKDIR\sales\hank\letters 


You can have subdirectories with the same name, but they 
must have different paths. 


ORDERS LETTERS ORDERS LETTERS 
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MODE 


Format 


The MODE command, in general, allows you to change the 
configuration of various devices attached to your system. It has 
several formats each of which has its own separate explanation: 


1 Set the display type and keyboard typematic rate 
MODE displaymode [,lines] 
MODE [displaymode],m[,T] 


MODE CON[:] [LINES=lines] [COL=cols] 
[RATE=r DELAY=d] 


2 Assigning a printer 

MODE LPT#[:]=COM# 

3 Setting up a printer 

MODE LPT#[:][n][, {m][,P]] 

4 Setting up a communications port 


MODE COM#[:]baudrate[, [parity], [databits], 
[stopbits][,P]] 


5 Setting up and using code pages 


MODE device CODEPAGE PREPARE = ((cplist) 
filespec) 


MODE device CODEPAGE SELECT = cp 


MODE device CODEPAGE [/STATUS] 
MODE device CODEPAGE REFRESH 


You can get online help information by typing MODE /H at the 
command prompt. 
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MODE 


1 Set the display type and keyboard 
typematic rate 


Using MODE you can select the display type for your monitor 
and change the current display. This can involve changing 
between 40 and 80 columns on the screen, between 
monochrome and color, the number of lines on the screen or 
centering the display on the screen. You can also alter your 
keyboard typematic rate (which is how quickly characters are 
echoed to the screen when a key is held down). 


Setting the display type 
Format 


MODE displaymode [,lines] 


Explanation 


This format of MODE allows you to set the display type for a 
monitor. You might use this command when you have fitted a 
graphics adapter and an alternative monitor onto your system, 
and you want DR DOS to work with the new monitor. 


The display types that can be selected are listed below. The 
mode you have selected remains until you type another MODE 
command or restart DR DOS. 

C040 Enables the graphics adapter and sets the 
display width to 40 characters per line with a 
color display. 

CO80 Enables the graphics adapter and sets the 
display width to 80 characters per line with a 
color display. 


BW40 Enables the graphics adapter, sets the display 
width to 40 characters per line, and the display 
mode to black and white. 


BWs80 Enables the graphics adapter, sets the display 
width to 80 characters per line, and the display 
mode to black and white. 
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If the graphics adapter is already enabled you can use the 
following commands: 


40 Sets the display width to 40 characters per line. 
80 Sets the display width to 80 characters per line. 
MONO Switches the active display to the original 


monochrome display (if you have one fitted). 
This display always has a width of 80 
characters per line. 


,lines This option sets the number of text rows (25, 43 
or 50) on the screen. 


Examples 


This command enables the graphics adapter, sets the display 
width to 80 characters per line, and the display mode to black 
and white: 


C>MODE BW80 


This command selects 80 columns by 48 lines: 


C>MODE 80,43 


On mono VGA, mode CO80 is often used to make an application 
believe that it has a color screen, or conversely is in mono 
mode. The following command when used on a system with a 
mono VGA screen, will select mono mode or color mode (with 
colors shown as gray scales): 


C>MODE CO80 


Aligning the display on a CGA monitor 


CGA or Color Graphics Monitors do not always display 
information properly. The MODE command can be used to 
center data so it is more readable, the format is: 


MODE [displaymode],m[,T] 


where: 


displaymode ‘Type of display you want to specify, see the list 
on the previous page. 

ym Shifts the display right or left; enter R for right, 
L for left. 
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ar ag a nnn 


Pils Causes a test pattern to be displayed so you can 
see how the screen will be aligned. You will be 
asked if the alignment is acceptable. If you 
answer N, the display will be shifted again and 
you can continue this procedure until the 
display is correctly positioned. 


Example 


This command shifts the display one column to the right and 
then asks you if you can see all of the test pattern. 


MODE ,R,T 


Setting lines, columns and the keyboard typematic rate 


To set the number of columns and lines on a display or the 
keyboard typematic rate (which is how quickly characters are 
echoed to the screen when a key is held down), use the MODE 
command in the form: 

MODE CON[:] [LINES=lines] [COL=cols] 

(RATE=r DELAY=d] 


where: 

lines Indicates the number of lines on the display. 

cols Represents the number of columns on the 
display. 

r Sets the typematic interval time ( that is the 
speed at which characters are repeated on the 
screen), in the range 1-32 where 1 is the slowest 
repeat. 

d Specifies the auto-repeat start-delay time with 


the possible values of 1-4 (that is if you press 
and hold down the F key on your keyboard, 
auto-repeat start-delay is how long it is before F 
is repeated). Note that 1 is the longest delay. 


Note 
To set the typematic rate you must specify the 
rate and delay at the same time. 
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Examples 
This command selects 80 columns by 43 lines on the display. 
C>MODE CON: COL=80 LINES=43 


This command sets the keyboard typematic rate to 32 (the 


shortest rate permitted), and the auto-repeat start-delay to 1 
(the shortest delay allowed). 


C>MODE CON: RATE=32 DELAY=1 
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MODE 
2 Assigning a printer 


Format 


MODE LPT#[:]=COM# 


Explanation 


With this form of MODE you can alter the standard 
assignments for your printer ports. 


DR DOS lets you connect up to three printers to your computer. 
Usually information is sent to these printers through your 
computer’s parallel ports, commonly labeled LPT1, LPT2, and 
LPT3. The MODE command enables you to send information to 
a serial printer through one of your computer’s serial ports 
instead. (The serial ports are sometimes called COM ports or 
communications ports and are labeled COM1 and COM2). For 
example if you have a program (such as a wordprocessor) that 
normally sends output to port LPT1, you can use MODE to 
redirect information to a serial port like COM1 instead. 


The hash symbol # represents the number of the port, for 
example LPT# could be replaced with LPT1. The colon between 
LPT# and =COM+# is optional. 


To return to the default settings, type the LTP#: without the 
COM#. 


Examples 
To redirect output from LPT1 to COM1, type the following: 
C>MODE LPT1:=COM1 


This causes a small part of MODE to be transferred into system 
memory and you see the message: 

MODE: Resident portion installed 
To return to the default settings type: 


C>MODE LPT1: 
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MODE 


3 Setting up a printer 


Format 


MODE LPT#[(:][n][,[(m][,P]] 


Explanation 


Use this format of MODE to tell DR DOS what kind of printer 
is connected to a particular port. Your printer documentation 
should help indicate the values you need (for example for n). 


Options Explanation 

LPT#: The printer number, where # can usually be 1, 
2, or 3. 

n The printer characters per line: 80 or 132. The 


default is 80. (80 character printers are often 
known as "narrow carriage", and 132 character 
printers as "wide carriage”.) 


m The lines per inch for the printer: 6 or 8 (8 is the 
default). 
5P Tells DR DOS to keep on trying to send 


information to a printer that is not printing. 
Without ,P DR DOS will try for only a short 
length of time before issuing a timeout error 
message. 


When you issue MODE with ,P a small part of 
the MODE program is transferred into system 
memory and you see the message: 


MODE: Resident portion installed 


If you select ,P and then find that you want to 
stop DR DOS continuously trying to send 
information, press Ctrl+Break. To remove the 
,P option altogether, type the MODE LPTn 
command without the ,P. 
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a 
Examples 


This command instructs DR DOS to continue trying to send 
information to a wide printer at printer port LPT2. 


C>MODE LPT2:1382,,P 


The following command returns to the default settings on the 
same port: 


C>MODE LPT2 
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MODE 


A Setting up a communications port 


Format 


MODE COM#[:]baudrate[, [parity], [databits], 
[stopbits][,P]] 


Explanation 


This form of the mode command enables you to set 
communications parameters for your serial (or communication) 
ports, for example COM1 and COM2. 


The command allows you to set baud rate, parity, data bits, and 
stop bits, and allows timeout errors to be retried continuously. 


Usually you will find that you only need to set the baud rate; 
the default values for the other options may already be set up 
for your needs. 


Options Explanation 


baud rate Can be 110, 150, 300, 600, 1200, 2400, 4800 and 
9600, (on some computers like IBM PS/2 also 
19200). You only need to type the first two digits 
of your selection. 


parity Can be N (none), O (odd) or E (even, which is 
the default). 

databits Can be 7 or 8 (7 is the default). 

stopbits Can be 1 (the normal default) or 2 (the default 
when the baud rate is set at 110). 

Pg Tells DR DOS to keep on trying to send 


information to a device which is not responding. 
Without ,P DR DOS tries for only a short length 
of time before issuing a timeout error message. 


When you issue MODE with ,P a small part of 
the MODE program is transferred into system 
memory and you see the message: 


Infinite retries on serial port COMn: 


MODE: Resident portion installed 
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eee 


If you select ,P and then find that you want to 
stop DR DOS continuously trying to send 
information, press Ctrl+Break. To remove the 
,P option altogether, type the MODE COMn 
command without the ,P. 


Note 

Always separate the different options in the command line with 
commas. If options are not required, the correct number of 
commas must still be inserted. 


Examples 


The following command sets the communications parameters 
(sometimes called protocol) on COM1 to 9600 baud. The 
defaults for the other values will be: even parity, 7 databits, 1 
stopbit. 


C>MODE COM1:96 


The following command changes the protocol for the above 
command to odd parity: 


C>MODE COM1:96,0 


The following command sets the protocol on COM2 at 4800 
baud and 8 databits, and specifies continuous retry: 


C>MODE COM2:48,,8,,P 
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MODE 


5 Setting up and using code pages 


About code page switching 


Code page switching is a mechanism DR DOS uses to allow you 
to use the range of characters needed in a variety of national 
languages. Using it you can switch between the different 
character sets needed by differing languages. A code page is a 
table stored in your computer which defines the particular 
character set required by a specific national language. 


Normally you only need to set your computer up for code page 

switching if you: 

QO write documents which are to be used on a computer in 
another country. 


Q receive foreign language documents in which certain letters 
become unintelligible when displayed or printed. 


QO are using an application that is difficult to read on the 
screen because some graphics characters, such as boxes, 
appear as letters. 


The MODE code page options are used to prepare, select, 
display and refresh code pages. 


For more information on code page switching, see Chapter 10. 


Note 


All printers must be switched on and be online when MODE 
commands that affect the printers are used. Otherwise you get 
an error message; this may take some time to appear. 
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Preparing code pages 


Format 


MODE device CODEPAGE PREPARE = ((cplist) filespec) 


Explanation 


This form of the MODE command is used to prepare one or 
more code pages. 


All parameters must be entered on the command line. 


Options Explanation 


device Can be one of: CON PRN or LPTn where n is 1, 
2 or 3. (PRN is equivalent to LPT1.) 


CODEPAGE Can be abbreviated to CP. 
PREPARE Can be abbreviated to PREP. 


cplist Specifies the list of one or more code pages that 
are to be prepared. The following code pages can 
be prepared: 437, 850, 860, 863 or 865, see 
Chapter 10 for more information on what you 
should select. 


If more than one code page is to be prepared, 
the numbers must be separated by a comma. 


The list must be enclosed in brackets as shown. 


filespec Defines where to find the file that contains the 
character shapes for the code pages. In DR DOS 
the following files are supplied: 


EGA.CPI for EGA/VGA display devices 
4201.CPI for IBM Proprinter & XL printers 


4208.CPI for IBM Proprinter X24 & XL24 
printer 


5202.CPI for IBM Quietwriter III printer. 
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You can leave a code page in the cplist parameter unspecified so 
that it remains unchanged, by placing a comma in the cplist 
without a preceding number. For example the command: 


MODE LPT1 CP PREP = ((,850) \4201.CPI) 


leaves the first code page unchanged and prepares 850 as a 
second code page. 


Examples 


The following command prepares Code Page 850 for the CON 
display device using the fonts file in drive A: 


C>MODE CON CP PREP = ((850) A: \EGA.CPI) 


This command prepares the first and third code page for the 
printer on LPT1 using a file in the directory drdos on the hard 
disk: 


C>MODE LPT1 CP PREP = ((850,,863) C:\DRDOS\4201.CPD) 


When the command is completed, you will see the message: 


Codepage prepare function completed 


222 MODE 


Selecting a code page 


Format 


MODE device CODEPAGE SELECT = cp 


Explanation 


Only one code page can be active on a device at any time. The 
MODE PREPARE command only prepares code pages; this 
version of MODE defines which of the prepared code pages will 
be the active (selected) one on a device. 


Option Explanation 


device Can be one of: CON PRN or LPTn where n is 1, 
2 or 3. (PRN is equivalent to LPT1.) 


CODEPAGE Can be abbreviated to CP. 
SELECT Can be abbreviated to SEL. 


cp The number of the code page that is to be 
selected. The following code pages are 
supported: 437, 850, 860, 863, or 865. 


Examples 


The following command selects Code Page 850 for the printer 
on port LPT2. 


C>MODE LPT2 CP SEL = 850 


When the command is completed, you see the message: 


Completed codepage select function 
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Displaying the selected code page 


Format 


MODE device CODEPAGE [/STATUS] 


Explanation 


The selected code page number is displayed, followed by a list of 
prepared code pages. You see: 


Active codepage for device XXX is NNN 


hardware codepages: 
codepage NNN 
prepared codepages: 
codepage NNN 


Completed codepage status function 


where XXX is the specified device and NNN is a code page 
number. 


The list is divided into hardware code pages defined in the 
DEVICE statement in the config.sys file, and code pages 
prepared using the MODE PREPARE command. 


Option Explanation 


device Can be one of: CON PRN or LPTn where n is 1, 
2 or 8. (PRN is equivalent to LPT1.) 


CODEPAGE Can be abbreviated to CP. 


/STATUS Can be abbreviated to /STA, or omitted 
altogether. 


If no code page has been selected for the device, you see: 


No codepage has been selected 


If you have specified additional code pages in the DEVICE 
statement but have not prepared them, you see: 


Codepage not prepared 
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Example 


The following command displays the code pages for the CON 
display device. An example status message is also shown. 


C>MODE CON CP 


Active codepage for device CON is 850 


hardware codepages: 
codepage 437 
prepared codepages: 
codepage 437 
codepage 850 


Completed codepage status function 
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Refreshing a code page 


Format 


MODE device CODEPAGE REFRESH 


Explanation 


This command refreshes the active (selected) code page for the 
device specified. For example, if a printer has been turned off, it 
may have lost the code page information. Using this command 
you can reload the fonts for the active code page on to the 
printer. 


Option Explanation 


device Can be one of: CON PRN or LPTn where n is 1, 
2 or 3. (PRN is equivalent to LPT1.) 


CODEPAGE Can be abbreviated to CP. 
REFRESH Can be abbreviated to REF. 


Example 


The following command refreshes the code page on the printer 
on port LPT1. 


C>MODE LPT1 CP REF 


When the command has been completed, you see: 
Completed codepage refresh function 


If the printer is not switched on or online when the REFRESH 
command is entered, an error message is given when your 
system’s timeout period has elapsed. There may be a delay 
before the message is displayed depending on the length of the 
timeout period. 
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MORE 


Format 


source | MORE 


Explanation 


The MORE command is a filter that takes input from a 
standard input device (for example a redirected file or a piped 
command) and then displays it a screenful at a time. At the 
bottom of each screen (except the last one) the phrase: 


Strike a key when ready . 


is shown. Move to the next screen by pressing any key. 


Example 
Use MORE with the DIR command to display a large directory 


_ascreenful at a time. The output from DIR is piped to MORE 


and then displayed. 
A>DIR c: | MORE 


For more information on piping, see Chapter 6. 
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NLSFUNC 


Format 


NLSFUNC [/H] filespec 


Explanation 


NLSFUNC provides support for extended country information 
and allows you to use the CHCP command to select code pages 
for all devices set up to use them. 


NLSFUNC must be loaded before you can use the CHCP 
command. To load NLSFUNC, type NLSFUNC on its own at 
the command line. It uses the country-specific information 
specified by the country.sys file. The country.sys file used is 
the one as specified by the COUNTRY= statement in your 
config.sys file. (You can use the SETUP program to modify 
your config.sys file, see Chapter 9.) 


NLSFUNC followed by filespec, specifies the filename and 
location of the country information file to be used, for example: 


NLSFUNC c:\drdos\country.sys 


Command switch 


/H Displays help text. 


For more information on code page switching, see Chapter 10. 
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PASSWORD 
Format 
PASSWORD [/H] [@]wildspec[...][/R|/W|/D|/P|/G[:password] ] 


[/N] [/NP] [/NG] [/S] 


Explanation 


The PASSWORD command is used to assign passwords to files 


or paths. 


Passwords can be up to eight letters long. 


Command switches 


/A 
/R:password 


/W:password 


/D:password 


/P:password 


Displays help text. 


The password is required for reading, copying, 
writing, deleting, renaming, and changing the 
file’s attributes. /R creates the password 
attributes R,W,D. 


The file can be read without giving a password, 
but the password is required to copy, delete, 
rename or change the file’s attributes. /W 
creates the password attributes W,D. 


The password is required only for deleting or 
renaming the file. You do not need the password 
to read, modify or change the file’s attributes. /D 
creates the password attribute D. 


The password operates on subdirectories 
instead of files. This means each time you try to 
use the path to access a directory you are 
prompted for a password. Subdirectories are 
automatically given full read, write and delete 
protection when a password is applied. 
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/G:password _ Sets the global default password. DR DOS 
remembers this default password and tries it 
against each password-protected file you then 
try to access. This is useful if a group of files 
have the same password and you want to access 
the files without typing a password each time. 
The global default password remains set until it 
is removed, or until the computer is reset. It is 
also used before a non-password aware 
application is used with password-protected 
files. 


/N Removes any password protection. Note that 
you have to give the password first in order to 
remove it. /N can also be used in combination 


with the /P and /G options: 

/NP Removes password protection from a directory. 

ING Removes the global default password. 

/S The password operates on files and 
subdirectories associated with the current 
directory. 


Examples 


The following example assigns the password SUZE to the file 
eyesoff.let, and ensures that the password must be given 
before the file can even be read. 


A>PASSWORD eyesoff.let /r:suze 


The following command protects all files with the -bas 
extension in the \handsoff directory and in all the associated 
subdirectories. The level of protection is set at W; the files can 
be read but not copied, renamed, deleted or altered. Note that 
you do not need to use the password to access the \handsoff 
directory or the subdirectories; you only need the password 
with *.bas files. 


A>PASSWORD c:\handsoff\*.bas Aw:simon /s 


The following example assigns the password WINSTON to the 
subdirectory top in the path e:\secret\top: 


A>PASSWORD c:\secret\top /p:winston 
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If you then type: 
A> CHDIR c:\secret\top;winston 


you can access the files associated with the subdirectory 
\secret\top without using the password again (as long as the 
files are not individually password-protected). 
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PATH 


Format 


PATH [d:]dirpath [;[d:]dirpath....] 


Explanation 


PATH sets a search path for commands or batch files not found 
by a search of the current directory. If a command cannot be 
found in the current directory, DR DOS searches the named 
directories in the order you entered them, but does not change 
the current directory. The maximum length of a search path is 
123 characters. 


PATH with no parameters displays the names indicated in the 
previous PATH command. (The search paths currently defined.) 


PATH with a semi-colon: 
C>PATH; 


resets the search path to no extended search path or a “null” 
path. If no path is specified, DR DOS only searches in the 
current directory of the current drive. 


Incorrect information in the paths will not be found until the 
specified paths are searched. If a specified path does not exist, 
DR DOS ignores that path and goes to the next. 


If the command entered is not found in any of the directories 
specified in PATH, the message: 


Command or filename not recognized 


is displayed. 


Examples 


In the following example, spell.com is contained in directory 
mydir on drive B:, and the default drive is drive A: 


A>PATH a:\subl;a:\sub1\sub2;b:\mydir 


This command sets the search path so that when you type spell 
at the command line DR DOS looks into the current directory of 
the current drive specified, followed by a:\sub1, then 
a:\sub1\sub2, then b:\mydir, until spell.com is found and 
loaded. 
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If you enter the command: 
A>SPELL 


DR DOS searches four directories and finds program spell in 
b:\mydir. 
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PRINT 


Format 


PRINT [/H] [wildspec] [/D:device] [/B:buffsiz] 
[/U:busy-ticks] [/M:max-ticks] [/S:timeslice] 
{[/Q:queuesize] [/T] [/C] [/P] 


Explanation 


PRINT is used to print text files. When you have created files 
on disk that need printing, you can use PRINT to manage the 
print process. PRINT creates a list of files called a print queue 
and then prints the files one by one. 


PRINT runs in the background, leaving your computer free so 
you can carry on working as normal. PRINT is an external 
command in DR DOS, but part of it remains loaded in memory. 
When you start the PRINT command, you see the message: 


Resident part of PRINT installed 


Command switches 


/H Displays help text. 


/D:device Sends the printer output to the named device. 
The default is PRN (which is the same as 
LPT1). The other valid devices you can name 
are: AUX, COM1, COM2, LPT1, LPT2, and 
LPTS3. The device name can only be specified the 
first time the PRINT command is used during a 
DR DOS session. 


/B:buffsiz Sets the size of the print buffer (in bytes). The 
default is 512. A larger buffer can (sometimes) 
improve the print speed. The buffer size can 
only be set the first time the PRINT command is 
used during a DR DOS session. 


/U:busy-ticks 

/M:max-ticks 

/S:timeslice These parameters work together to govern what 
portion of computer time PRINT is allowed to 
use. Timeslice (default 8) describes how often 
the computer gives control to the PRINT utility; 
max-ticks (default 2, range 1 through 255) 
governs for how many clock-ticks PRINT runs 
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once it has control; busy-ticks (default 1) 
specifies how long PRINT waits before handing 
back control if the printer is busy. (A clock-tick 
is approximately 1/18th second.) 


Note 

Each of these parameters can only be specified 
the first time you issue the PRINT command 
during a DR DOS session. 


/Q:queuesize Sets the maximum number of files that can be 
held in the print queue. The default is 10, in 
the range 4 to 32. This parameter can only be 
defined the first time you use PRINT during a 
DR DOS session. 


al Deletes all the files from the print queue. The 
printer prints the message: 


All files cancelled by operator 


/C Deletes the named file(s) from the print queue. 
Filenames can be typed before or after this 
option in the command line: the option looks at 
the one filename immediately preceding it in 
the command line and at all the filenames typed 
after it. 


/P Adds the named files to the print queue. The 
rules for using it are the same as those 
governing the /C option. 


Examples 


If you type this command when using PRINT for the first time 
after starting up DR DOS: 


C>PRINT /Q:20 chap1.doc 
the command sets the spool queue size to 20. As the /D option 
was not given, you get this message: 

List device? [PRN] 


You need to press Enter to print via the default port LPT1 
(LPT 1 is equivalent to PRN). Type the port name if you want to 
print via another port. If PRINT was already started, using the 
/Q option would result in an error message. 
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The following command deletes the files chap2.doc and 
chap3.doc from the print queue: 


C>PRINT chap2.doc /c chap3.doc 
PRINT allows you to combine several commands on one 
command line. 


The following command deletes all the files on the print queue 
and then adds files newbook1.doc and newbook2.doc to the 
queue: 


C>PRINT /T newbook1.doc newbook2.doc 


236 PROMPT 


PROMPT 


Format 


PROMPT [promptstring] 


Explanation 


The PROMPT command modifies the command prompt. You 
can set the command prompt to contain any valid ASCII 
characters or certain special character-strings. 


Type PROMPT with no parameters to reset the command 
prompt to the default DR DOS prompt. The default prompt 
displays the standard DR DOS prompt, A>. (The default 
prompt is indicated by $n$g where $n is the default drive letter 
and $¢ is the character >.) 


The command prompt can be any of the valid ASCII characters 
or one of the following (you must precede it with a dollar sign, 
$, for example $t): 


$ = The $ character. 

t = The time. 

d = The date. 

p = The current directory path of the default drive. 
v = The version number. 

n = The default drive letter. 

g = The “>” character. 

1 = The “<” character. 

b = The | character. 

q = The = character. 

h = A backspace; the previous character is erased. 
e = The ESCape character. 


_ = The CR LF sequence (Carriage-return and line feed, go 
to beginning of new line of the display screen). 


Any other value for c is considered invalid and ignored by 
PROMPT (for example $c). 
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Examples 
The following command sets the DR DOS prompt to HELLO: 
A>prompt HELLO 


HELLO 


The following command sets the DR DOS prompt to the default 
drive and path plus the character >. This is the recommended 
prompt for use on a hard disk. 


A>PROMPT $p$g 


A:\WORDPROC\LETTERS> 

The following command sets the DR DOS prompt to display the 
time and date: 

A>prompt TIME = $t$_DATE = $d 


The DR DOS prompt appears as follows: 
TIME = (current time) 
DATE = (current date) 
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WARNING 


RECOVER 


Format 

RECOVER [/H] wildspec 

To recover a single file or group of files 
or 

RECOVER d: 


To recover an entire disk or drive 


Explanation 


The RECOVER command enables you to retrieve information 
from files that have been corrupted. If you have a file that is 
only partially readable, RECOVER removes the unreadable 
parts so you can access the rest. It has two forms: you can 
either recover individual files or groups of files, or you can 
recover an entire disk. 


Command switches 


/H Displays help text. 


Only recover a disk if your root directory is corrupted, 
because if you only specify a disk RECOVER assumes the 
entire disk is scrambled and replaces your root directory 
with a new one. All the information contained in your files 
is re-organised into a series of files as described above, and 
you then have to sort out where your data is and 
re-structure it. 


1 Recovering a disk 


To recover an entire disk you type: 
RECOVER d: 


Each recovered file is converted into a file in the 
root directory. These files have filenames in the 
form FILExxxx.REC, where xxxx specifies a number 
starting at 0000. 


8: RECOVER 239 


Note 


You may need to repeat the operation if there are more cluster 
chains to convert than there are available entries in the root 
directory. In this case you should copy the first set of recovered 
files to another directory on another disk, delete them from the 
root directory, and then re-issue the command. 


2 Recovering individual files 


You can use RECOVER to recover single files or a specific 
group of files (you can use wildcards in the specification). For 
example: 


C>RECOVER c:\reports\invoice 


In this case each file in the path that matches the specified 
filename, for example invoice, is checked for bad areas (or 
“blocks”). If DR DOS finds any bad blocks they are skipped over 
and marked as bad blocks in the File Allocation Table. The 
record of the file’s length (shown when you use the command 
DIR) is also modified to reflect the new length of the file. 


Once you have recovered the file or files, you can edit them and 
re-enter lost information. 


Remarks 


If you specify a subdirectory in the command syntax, it means 
that the files in that subdirectory are recovered and copied to 
the root directory, not to the original subdirectory where the 
files were stored. 


RECOVER is most useful when you are attempting to recover 
text files. 


RECOVER does not work on networked drives. 


RECOVER does not work on drives affected by a JOIN or 
SUBST command. 
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Example 


This checks whether there are any bad blocks in the 
specification matching salesm?.doc in directory reports on 
drive C:. Any bad blocks are marked in the File Allocation Table 
and the record of the files’ length is modified accordingly. 


C>RECOVER c:\reports\salesm?.doc 


Password-protected 


files 
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RENAME | REN 


Format 


RENAME oldwildspec newwildspec 


Explanation 


The RENAME command lets you change the name of a file or 
move a file between subdirectories on the same disk. RENAME 
can be shortened to REN. 


] Renaming a file 


If the file to be renamed is not on the current drive or in the 
current directory, you must precede the old file specification 
with the correct drive/path specification. The following 
command line renames myfile.typ as file1.txt: 


A>REN b:myfile.typ filel.txt 


On password-protected files, you must enter the default 
password before renaming a file. The same file password is 
then required to access the new file specification. You can 
remove the password protection on the file before renaming it 
(see the PASSWORD command). 


Wildcards can be used, for example the command: 

B>REN *.in *.out 

renames all files with the file extension .in, so that they have 
the file extension .out. 


RENAME does not let you rename a file to an existing name. If 
you attempt to do this the message: 


File already exists 


is displayed, and the command prompt returned. Any files 
designated to be renamed remain unchanged. 
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2 Moving files 


RENAME can be used to move files between subdirectories on 
the same disk. For example the command: 


A>REN myfile.lst \wordproc\memos 


moves myfile.Ist to the directory a:\wordproc\memos; 
myfile.lst no longer exists on the original directory. 


Note 


This operation can save time when you want to move several 
files. Previously you would have had to copy the files then 
delete the originals. Using RENAME only the directory entries 
are moved so the operation is very fast. 
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REPLACE 


Format 


REPLACE [/H] [@]wildspec [dirpath] [/A] [/H] [/M] 
{[/N] (/P] (/R] [/S] [/U] [/W] 


Explanation 


REPLACE copies selected files from a source to a destination. 
It is useful for updating previous versions of files. For example, 
you can add files to a destination directory or you can replace 
only files that have been changed since the last copy. Use the /A 
switch to add files to a subdirectory. 


The wildspec is the drive, path and name of the source files; 
dirpath shows the drive and path where you want the files to be 
placed. 


As well as replacing single files in one directory, you can also 
replace files across subdirectories using the /S switch. 


Command switches 


Displays help text. 
Copies only files not already on the destination. 


Does not ignore files with hidden or system 
attributes. 


Merges changed files on the source with 
unchanged files at the destination. 


Preview operation - does not actually copy any 
files. 


Prompts before copying each file. 
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Overwrites read-only files on the destination 
with fresh copies from the source. 

IS Looks in subdirectories of the destination for 
files that match the wildspec. 


/U Only copy files that are older on the destination 
than on the source. 


/W Waits for disks to be changed before starting to 
look for the source files, and waits before 
starting to copy them to the destination. This 
allows the REPLACE program to be loaded from 
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a diskette, the diskette changed for the source 
diskette, and then changed for the destination 
disk. 


Example 


The REPLACE option is especially useful for updating 
software. For example, you might have a program called 
wcounter.bas in various subdirectories on your hard disk. If 
you change the copy of weounter.bas in the \wordproc 
directory, you can copy the changed version of the file to all the 
other places in the hard disk by using the following command: 


C>REPLACE a:\wordproc\wcounter.bas c:\ /s 
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RESTORE 


Format 


RESTORE [/H] source drive destination_drive 
[filespec] [/S] [/P] [/A:date] [/B:date] 
[/E:hh:mm:ss] [/L:hh:mm:ss] [/M] [/N] [/R] 


Explanation 


Restores directories and files that were backed up with the DR 
DOS BACKUP utility. Source_drive is the drive containing the 
backed up files, and destination_drive is where you want to 
restore your files to. RESTORE prompts you for each backup 
diskette in turn until all the files you specified are restored. 


Command switches 


/H Displays help text. 

IS Restores all subdirectories associated with the 
current directory on the destination disk. 
RESTORE will create the required 
subdirectories on the destination disk if 


necessary. 

/P Prompts you for permission to restore read-only 
files, or files that have changed since the last 
backup. 

/A:date Restores all the files that have been altered on 


the original disk on or after the date specified. 
The format of the date depends on the current 
country code (see the DATE command). 


/B:date Restores all the files that have been altered on 
the original disk on or before the date specified. 
The format of the date depends on the current 
country code (see the DATE command). 


/E:hh:mm:ss_ Restores all the files that have been altered on 
the original disk at or earlier than the time 
specified. 

/L:hh:mm:ss_ Restores all the files that have been altered on 
the original disk at or later than the time 
specified. 
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/M Restores all the files that have been altered on 
the original disk, or deleted, since the backup 
was taken. 


Restores files that do not exist on the 
destination. 


/R Reports which files would be restored, but does 
not take any action. This is useful for checking 
that you will restore the files that you want. 
This option also checks the integrity of backup 
disks. 


Remarks 


RESTORE reports any errors during the restoration process 
using the codes shown in Table 8-12. 


Table 8-12 RESTORE error codes 


Code Explanation 


Normal completion. 


No files found to restore. 


2 Some files not restored due to file sharing 
conflict. 
3 Restoration process ended by a Ctrl+Break. 


Restoration process ended by an error. 


This feature can be useful in creating batch files with an IF 
ERRORLEVEL statement in them to improve the process, see 
Chapter 7. 


Do not use the RESTORE program with disks affected by an 
ASSIGN, JOIN, or SUBST command. 
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Examples 

This example restores a backup of all files on all directories on 
drive C:. 

C> RESTORE a: c¢:\ /s 


This command restores the file letter.doc in the subdirectory 
\backedup on drive C: 


C> RESTORE a: c:\backedup \letter.doc 
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RMDIR/RD 


Format 


RMDIR | RD [d:]dirpath 


Explanation 


The RMDIR command removes a specified subdirectory. The 
subdirectory to be deleted must be empty except for the (.) and 
(..) markers which refer to the directory itself, and its parent 
directory; these entries cannot be deleted. RMDIR can be 
abbreviated to RD. 


Before you remove a subdirectory, ensure that: 


1 The subdirectory contains no files or additional 
subdirectories. 


“1 The subdirectory is not the current directory on any drive. 


The subdirectory is not in use by a SUBST or JOIN 
command. 
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Remarks 


If you get the error message: 


Directory not empty or in use 


but when you check the relevant subdirectory only the . and .. 
entries can be seen, check again with the XDIR command. The 
XDIR command will show if any hidden, system, or 
password-protected files are present. 

Examples 

This command erases subdirectory france on drive A:. 
A>RMDIR clients\ foreign \ france 


This command erases subdirectory acets.rev on drive C:. 


A>RD c:\finance\accts.rev 
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SET 


Formats 


SET 


Show DOS system environment 


SET name=parameter 


Set a name 


SET name= 


Delete a name 


Explanation 


SET inserts variable strings into the command processor’s 
environment. All the strings in the environment are available 
to all commands and applications. 


The string (beginning with name) is inserted into a part of 
memory reserved for environment strings. Lower case letters in 
the name are converted to upper case when added to the 
environment. If the name was in the environment, it is replaced 
by the new parameter. 

If you type SET with no options you see a list of the strings 
already in the environment. 

To delete a name from the environment, type SET with a name 
and no parameter, for example SET name=. 


Remarks 


Among the strings set automatically by DR DOS when DR DOS 
is started are: 


COMSPEC=C: \COMMAND . COM 


and 


OS=DRDOS 


COMSPEC defines the path to the command processor. (The 
command processor in DR DOS is called COMMAND.COM.) 
COMSPEC is used by programs that sometimes look for the 
command processor; typically programs that allow you to access 
operating system commands without leaving the program. 
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COMMAND.COM is provided with DR DOS; you can, however, 
insert your own command processor instead by setting a new 
COMSPEC. 


OS describes the operating system type. This environment 
string is useful for distinguishing between operating systems. 
For example, if you run two or more different operating 
systems at different times on one computer, you can devise a 
batch file that looks for the OS environment string, finds which 
operating system is present, and then takes appropriate action. 


SET can be used in your autoexec.bat file to automatically set 
strings when you start DR DOS. 


Example 


With the following command, if the operating system currently 
running is DR DOS, it attempts to load the UK keyboard driver 
into upper memory using the HILOAD command. If a different 
operating system is running, it does nothing. 


IF "%0S%" == "DRDOS" HILOAD KEYB UK 
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SHARE 


Format 


SHARE [/H] [/L:nnnn|/X] 


Explanation 


SHARE is a DR DOS program which provides support for file 
locking, (a means by which a file, or part of a file, may be 
reserved for unique access by one program) and so allows file 
sharing. It is used with networked systems and some 
Terminate-Stay-Resident programs, where the same data and 
files need to be shared at the same time by different programs. 
SHARE, as its name implies, coordinates this sharing of 
information. When SHARE is loaded, DR DOS checks all read 
and write requests made. 


Command switches 


/A Displays help text. 
IX Disables SHARE. 
/Linnnn Allocates the number of file locks you want, 


where nnnn is a decimal number in the range 
20 to 1024. The default, if you issue a SHARE 
command without specifying a value using this 
switch, is 20. 


Remarks 
As DR DOS has in-built support for large hard disks, it does 
not require SHARE to be loaded to access them. 


When SHARE is loaded, it increases the resident size of DR 
DOS in memory. 


You can put SHARE in your autoexec.bat file, so it is loaded 
every time you start up your system (see Chapter 9). 
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Examples 


To make 40 locks available in your system type: 
C>SHARE /L:40 


To disable SHARE: 
C>SHARE /X 
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SORT 


Formats 
SORT [/H] [/R] [/+n] <source 


or 


[source] | SORT [/R] [/+tn] 


Explanation 


SORT is a filter program which reads standard input, sorts it 
alphabetically, and then writes it to the standard output device. 


You can use the redirection symbols <> and | to pipe data from 
a filename or command through the SORT program. For 
example: 


C>DIR | SORT >filename.txt 

takes the output from the DIR command, sorts it and then 
redirects the sorted data to filename.txt. 

Note 


The SORT command does not differentiate between upper and 
lower case letters. 


Command switches 


/H Displays help text. 

/R Sorts in reverse order, that is 9 to 0, or Z to A. 

/+n. Makes the sort start on the “nth” column of a 
line. If omitted, the sort starts from the default, 
column 1. 

Remarks 


For more information on redirection, piping and the SORT 
command, see Chapter 6. 
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i 


Examples 


The following example reads and sorts the file index.dis and 
writes the output to the printer. 


A>SORT<index.dis>prn: 
The following example uses SORT to present a directory listing 


in reverse alphabetical order and then stores it in the file 
reverse.ord. 


A>DIR | sort /r >reverse.ord 
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SUBST 


Formats 
SUBST d: d:path 


To create a substitution 


SUBST d: /D 


To remove a substitution 


SUBST 


To display current substitutions 


Explanation 


SUBST allows you to make a subdirectory appear as if it were 
another disk drive. You do this by replacing a drive-and-path 
specification with a single drive letter. So, for example, you can 
replace a path like \wordproc\simon\letters with the drive 
F:. You can then use drive F: in your commands as if it was a 
real disk drive. This saves you from having to type in long path 
specifications over and again, and it can be used for programs 
which do not recognize subdirectories. 


Typing SUBST without any parameters displays the currently 
substituted drives. 


Use the /D parameter to remove substitutions when you have 
finished working with them. 


Caution When using substituted drives you should avoid using the DR 
DOS commands that involve entire disks: 


BACKUP FORMAT 
CHKDSK LABEL 
DISKCOMP RECOVER 
DISKCOPY RESTORE 
FDISK SYS 


Always switch off a substitution when you have finished 
working with it. 
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Examples 


The following example assigns drive F: to the path 
\wordproc\simon\letters on drive C:. 


A>SUBST f: c:\wordproc\simon \letters 


The example below removes the assignment from drive H:. 


A>SUBST h: /d 
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SYS 
Format 

SYS [/H] ad: 
Explanation 


Transfers the two main DR DOS system files and 
command.com, from the default drive (that is the drive on 
which SYS is being run) to a specified destination drive (d:). 


SYS allows you to transfer the operating system files to a 
diskette to make a drive bootable (some program diskettes need 
DR DOS on them to work), or to change them to match the ones 
on the default (or SYS) drive. 


SYS also transfers the command processor defined by 
COMSPEC to the root directory of the destination drive. 


Remarks 


DR DOS does not require space to be reserved for its system 
files on a disk, or that they be placed at the beginning of the 
disk; therefore you should have no problems making a disk 
bootable. 


SYS does not work on drives affected by a SUBST or JOIN 
command or across networks. 


Examples 
To transfer the system files from drive C: to drive A: type: 
C>SYS a: 


To transfer the system files from drive A: to drive C: (you must 
have booted from drive A:) type: 


A>SY8S c: 
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TIME 


Formats 
TIME 


or 


TIME hh:mm:ss 


Explanation 


Use the TIME command to display or set the time of day. 
(DR DOS maintains it’s own internal clock.) DR DOS also uses 
time to record the time a file is created or updated. 


You must set the time whenever you start or reset DR DOS, 
unless you have a real-time clock with battery backup. (When 
you do not enter a time, DR DOS assumes the time 
00:00:00.00.) Put the TIME command in your autoexec.bat 
file to prompt you when you start DR DOS. The DR DOS clock 
works on a 24-hour basis. This means that 1pm is 13:00 and 
midnight is 00:00. 


A>TIME 
TIME displays the time and prompts you as follows. 


Time: hh:mm:ss.xx 
Enter time: 


You can press Enter to keep the current values. To enter a new 
time, enter the hours, minutes and seconds and then press 
Enter. Note that the last value shown above, xx, indicates 
hundredths of a second. 


The time values are defined as follows: 


bh is a one- or two-digit number from 0 to 23 indicating the 
hour 


“1 mm is a one- or two-digit number from 0 to 59 indicating the 
minute 


CI ss is a one- or two-digit number from 0 to 59 indicating the 
second 


TIME assumes that the first entry specifies the hour. The 
minutes and seconds are optional, and if they are not entered 
are set to zero. You must use a colon to separate the entries. 
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If you enter a number that is out of range, TIME returns the 
message and prompt: 


Invalid time specified 
Enter time: 


Examples 


The following command sets the time for 30 minutes and 59 
seconds after 10 pm. 


A>TIME 22:30:59 


The following command sets the time at 12 minutes after 
midnight. 


A>TIME 00:12 
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TOUCH 


Format 


TOUCH [/H] [@]wildspec[...] [/T:hh:mm:ss] 
[/D:date] [/F:E|J|U] [/P] [/R] [/S] 


Explanation 


TOUCH resets the time and date stamps for a single file or a 
group of files. If you change the date stamps on a group of files 
you can also alter the date format using the /F switch. 


Command switches 


/H Displays help text. 


/T:hh:mm:ss The time to be set. The time is set in 24 hour 
clock with midnight being 00:00. The default is 
the current time. 


/D:date The date to be set. The default is the current 
date. The date format depends on the current 
country code, set up in the config.sys file or the 
value specified in the /F: option. 


/F:[E1J1U] Specifies European, Japanese or USA date 
format for the date option before touching each 
file. This overrides the default format 
determined by the current country code. 


/P Prompts before touching each file. 

/R Includes read-only files in the touch operation. 

/S Touches files in subdirectories associated with 
the current directory. 

Examples 


This example resets the date stamps for all the .let files. The 
new date is 2 February 1989. Touch prompts you before 
changing each file. 


A>TOUCH *. let /d:02-02-89 /p 
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This command resets the date stamps for all the files states*.* 
using the US date format, overriding the date format set up in 
the config.sys file. 


A>TOUCH states*.* /d:06-22-89 /f:u 
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TREE 


Format 
TREE [/H] [d:] [/B] [/F] [/G] [/P] 


or 


TREE wildspec 


Explanation 


The TREE command displays the hierarchical path of 
directories and subdirectories on a disk, or if used with a 
wildspec finds all the files matching the wildspec on the disk. 


Command switches 


/H Displays help text. 

/B Displays in brief mode which leaves out the 
number of files in each directory. 

/F Displays all the files in the subdirectories, as 


well as the subdirectories themselves. 


/G Displays directory structure in graphical 
format, that is lines are drawn to show the 
directory structure. 


/P Pauses after each screenful in a long TREE 
display. 


Examples 


The command: 
A>TREE C: 


could generate the listing on the next page which shows that 
drive C: has five directories: john, georgia, melanie, 
programs and tools. It shows that john, georgia and 
melanie have subdirectories, and lists the space used and 
number of files belonging to each. 


A:N\>tree 
bytes files 
a a 
243,563 
463,698 28 
153,613 3 
9,728 1 
23,646 
19,456 
268 , 482 
27 , 384 
11,136 
46,564 
28,928 
total files 56 


AzN> 
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a=) 

i] 
fo 

=a 


:Ntools 

:\prograns 

:\john 

:\john\nenos 

iNjohn\ letters 

:\john\repor ts 

:Nmelanie 

:N\ne lanie\Nbook list 
a:\NnelanieNbook list\Nauthors 
a:\georgia 
a:\georgia\expenses 

otal bytes 1,170,112 


aooooooogd 


The same command but with the /G switch added would 


display: 


A:N>tree “g 
bytes 

a 

243,563 
463,698 
153,613 
9,728 
23,044 


19,456 
268,482 
27,984 
11,136 
46,564 
28,928 
total files 56 otal bytes 1,174,112 


AzN> 


tools 
rograns 
‘john 


enos 
letters 
eports 


elanie 
L—thooklist 
L—authors 
eorgia 
xPenses 
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The command: 
A> TREE *.gtm 


shows two files named *.gtm on drive A:. One is in the root 
directory, and one is in the subdirectory \dr\memos. 


A:\>tree *.gtn 

--a-—- 23,424 12-64-98 18:52a a:\Nnenoi.gtn 
26,928 12-64-96 4:65p = a:NdrSneno2.gtn 

total files 2 total bytes 52,352 


Aiz:N> 


-a- represents the files attributes, see the explanation for the 
ATTRIB command. 


Note 


This can be very useful when you are trying to find a particular 
file, but you cannot remember it’s exact name, or which 
subdirectory you placed it in. 
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TYPE 


Format 


TYPE wildspec[;password] [/P] 


Explanation 


The TYPE command displays the contents of a text file on your 
screen (if you try to display a program or binary file, you just 
see unintelligable characters). 

Password-protected If the file is password-protected for READ mode, you must set 

files the global password, or add the password to the end of the 
wildspec. Wildcard characters can be used to display multiple 
files. When you type the name of the file you must enter the full 
name and extension. 


Command switches 


/P Causes the text to be displayed a screenful at a 
time; move to the next screen by pressing any 
key. Press Ctrl+C to abort the display. 


Alternatively you can press Ctrl+S or Pause to 
stop the display from scrolling. To restart 
scrolling, press any key. 


Press Ctrl+P to have the file contents sent to the printer as 
well as the screen. Press Ctrl+P again to stop output to the 
printer. 

Examples 


This command displays the text file memo.txt on the screen a 
screenful at a time. 


C>TYPE memo.txt /P 


This command displays the contents of all files with the 
extension .bat. 


C>TYPE *.bat 
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VER 


Format 


VER 


Explanation 


VER displays the version of DR DOS that you are using. 
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VERIFY 


Format 


VERIFY [ON|OFF] 


Explanation 


VERIFY ON causes DR DOS to check that data is written to 
the disk correctly after each write operation. This, however, 

causes your system to run slightly slower and so the default 
value for VERIFY is OFF. 


Entering VERIFY with no parameters shows whether VERIFY 
is currently ON or OFF. 


If you switch VERIFY on, it stays on until you or a program 
specifically switches it off. 


Examples 

To check the current status of VERIFY: 
C>VERIFY 

VERIFY = on 

To switch VERIFY off: 

C>VERIFY off 
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VOL 


Format 


VOL [d:] 


Explanation 


VOL displays the volume label of the specified drive, or of the 
default drive if no drive is given. 


If the disk in the drive has no label then the message: 
Volume in drive d does not have a label 


is shown. 


Example 


The following command displays the volume label on the 
current drive C:. 


Cc> VOL 


Volume in drive C is Accounts 
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XCOPY 


Format 


XCOPY [/H] [@]wildspec [dirpath] [/A] [/D:date] [E] 
[/H] [/M] [/PIC] [/R] [/S] [/V] [/W] 


Explanation 

XCOPY (or Extended Copy) selectively copies groups of files. It 
can be used to copy whole subdirectories. 

The wildspec is the drive, path and name of the files to be 
copied. 


Dirpath is the destination drive and path to which the files are 
to be copied. 


Command switches 


/H Displays help text. 


/A Copies only those files that have the archive 
attribute set. The attribute of the source file is 
not changed. (See the ATTRIB command 
explanation in this chapter, for an explanation 
of the archive attribute and other attributes. 
Also Chapter 4, section 4.3) 


/D:date Copies only those files whose date is the same or 
later than the date specified. The format of the 
date depends on the current country code (see 


the DATE command). 

/E Creates subdirectories at the destination even if 
they end up being empty after all the copying is 
complete. 

/H Includes hidden and system files. (Files with 


the system attribute are explained in the 
ATTRIB command description.) The default is 
for system files to be ignored. 


/M. Copies files that have the archive attribute set 
and resets the attribute bit of the source file. 


/P or /C Prompts you to confirm each file before it is 
copied. 


/R Overwrites read-only files. 
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Password-protected 


files 


/S Copies the files in the source directory and files 
in all the subdirectories below it. 
IV Verifies that the data written to the destination 


is a true copy of data in the source. 


Waits for a diskette to be inserted before 
beginning to search for source files and (if, 
necessary) wait again before the files are 
written to the destination. Press a key to 
continue or Ctrl+C to stop the copying. This 
allows the XCOPY program to be loaded from 
diskette, the diskette changed for the source 
diskette, and then changed for the destination 
diskette. 


Remarks 


You can use XCOPY to rename files while copying them in the 
same way as the COPY command, by specifying a new file 
name for the destination file. 


Using XCOPY you can duplicate a tree of subdirectories and 
files on another disk. If you want an exact copy of a tree 
structure, you need to specify the /E switch as well as the /S 
switch to ensure all subdirectories including empty ones are 
copied. 

You can use XCOPY to copy a subdirectory from one type of 
disk to another disk with a different format. 


XCOPY can be used with password-protected files and 
directories; you are prompted for the password. For example, if 
the subdirectory sales was assigned the password MAGIC, and 
you entered the following command fromthe root directory: 


C> XCOPY c:\sales a: 


you are prompted: 
c:\sales ...path password? 
Type in the password and press Enter (it is not shown on the 


screen), and the contents of the subdirectory sales are copied to 
the diskette in drive A:. 


8:XCOPY 271 


a ————— 


Examples 


Suppose you have files in a directory called c:\wordproc 
which contains two subdirectories \wordproc\jenny and 
\wordproc\ olivia. You want to copy all the files that have the 
file extension .let from these directories on drive C: onto a 
diskette in drive A:. You also want the appropriate 
subdirectories to be created on the diskette in drive A:. You type: 


CSXCOPY \wordproc\*.let a: /e/s 


The next example copies all the files that are marked for 
archiving from a diskette in drive A: to another diskette in 
drive B:. (Note that the archive attribute is set by DR DOS 
whenever a file is written to and then closed.) You are prompted 
to insert a diskette in drive A: before the copying operation 
starts. The archive attribute is turned off at the source file to 
show that the file has been copied. 


A>XCOPY *.* b: /m /w 


The following command copies all the files listed in the file 
file.lst which is stored in the directory c:\fred to the directory 
d:\john. Each file specification in file.lst must start on a new 
line. 


C>XCOPY @c:\fred\file.Ist d:\john 
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Password-protected 


files 


XDEL 


Format 


XDEL [/H] [@]wildspec[...] [/D] [/N] [/0] [/P] [/R] 
[/S] 


Explanation 
XDEL is a command for deleting multiple files in subdirectories 
and removing empty directories. 


If no default password is given, you are prompted for the 
correct one before a password-protected file is deleted. 


Command switches 


/A Displays help text. 
/D Removes empty subdirectories. 
/N Deletes all the specified files without asking 


further permission. Use this switch with care. 


/O Overwrite files before deleting them. Normally, 
when you delete a file, DR DOS amends the 
directory entry for that file to show the space it 
previously occupied is now free, but keeps the 
actual file contents until another file requires 
its space. It is then overwritten by the new file. 
If you want to make sure the file is really erased 
off the face of the disk, you can specify the /O 
switch. 


ii enn ange epg cee 
WARNING _ Use the /O option with great care as once a file is deleted by 


it, it can never be recovered. 


/P Prompts you before deleting each file. You see 
the message: 


d:\path (Y/N)? 


/R Delete read-only files. 
IS Deletes files in subdirectories derived from the 
specified directory. 
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Example 


The following command deletes all files with the .doc extension 
from the current directory and all the subdirectories below the 
current directory. 


A>XDEL *.doc /s 


path: a:\ 

file: *.doc 

warning: FILES IN SUB-DIRECTORIES MAY BE DELETED 
Is this what you wish to do (Y/N) ? y 
az\f£irst.doc 

a:\sub1\mem1.doc 

a:\sub2\mem2.doc 

a:\sub3\letter3.doc 


A> 
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XDIR 


Format 


XDIR [/H] [+|-ADHRS] [wildspec] [/B] [/C] [/L] [/N] 
(/P] [/R] {[/S] [/T] [/W] [/2] 


Explanation 


XDIR is an expanded version of the DIR command, offering 
extra options for displaying the contents of directories and 
subdirectories. 


Command switches 


/H Displays help text. 


+1-A,D,H,R,S Includes (+) or excludes (-) files with a certain 
attribute. The default is for all the files to be 
displayed, including system files. See the 
ATTRIB command for details of the different 
attributes. 


/B Produces a brief directory display showing only 
filenames and paths. 


/C Computes and displays a hash code for each file. 
A hash code is a four digit hexadecimal number 
calculated from the bytes within the file. It can 
be used to verify that two files are the same. 


/L Produces a long display format. This is the 
default. 

/N Does not sort directory alphabetically. 

/P Pauses after each screenful of display. 

/R Reverses the sort order: either the alphabetical 


order by filename (the default), or the 
chronological order, set by the /T option see 


below. 

/S Displays the files in subdirectories derived from 
the specified directory. 

/T Sorts the directory by date and time, rather 
than by filename. 
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/W Displays the directory in a wide, abbreviated 
format. This is useful if your directory display 
would otherwise be too long for the screen. 


/Z Sorts the directory by file size. 


Examples 


The following example displays all the read-only files in the 
current directory and the associated subdirectories. 


A>XDIR +r *.* /s 


The following example displays all the files that match the 
specification memo*.* on the current directory, and sorts them 
into reverse chronological order, so that the most recent are at 
the top of the list: 


A>XDIR memo%*.* /t /r 


Customizing your 
system 


OU may want to adapt DR DOS to improve the efficiency of the 
programs that you use. DR DOS allows you to make adjustments to 
some of its standard settings or “defaults” via a program called SETUP. 


SETUP has menus of options that are easy to select and 
change. SETUP takes your changes and when you restart your 
computer after using it, automatically updates your system for 
you. 


Using SETUP you can alter such settings as: 

The allocation of computer memory as memory disks. 
Ol The default country. 

“1 The number of files that can be open at one time. 


When you use SETUP to change default values it automatically 
updates the DR DOS configuration files config.sys and 
autoexec.bat for you. You can directly edit these configuration 
files using EDITOR if you prefer. This chapter describes how to 
use SETUP, and the DR DOS configuration files and 
commands. Note that some advanced features can only be set 
up by directly editing the configuration files. 


278 DRDOS User Guide 


9.1 Using SETUP 


To start SETUP, type: 
C>SETUP 


A welcome screen appears listing all the keys you can use to 
move through SETUP and select options. The screens are 
similar to those that appear when you install DR DOS. 


SETUP has full context-sensitive help, just press the F1 key on 
a highlighted option or when the cursor is positioned on the 
field you are interested in. 


You can leave SETUP at any time and return to DR DOS by 
pressing F10. This will not do any harm to your existing system 
setup. You can also go back at any time in the future to change 
any values set. 


9.2 SETUP and the DR DOS configuration files 


The SETUP program changes the settings in two files that are 
specifically used by DR DOS to customize your system to 
exactly the way you want it. These files are config.sys and 
autoexec.bat. Every time DR DOS is started, it searches its 
root directory for both these files and carries out the commands 
contained in them. 


Config.sys has its own set of commands which are listed in 
section 9.3. 


When you install DR DOS a config.sys file is built up and 
copied into the root directory of the disk from which you start 
DR DOS (usually the hard disk). 


To see how your config.sys file is set up, enter: 


COIrYPE config.sys 
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ae eee 


You see something like this: 


SHELL = C:\COMMAND.COM /P /E:1024 
DEVICE = c:\DRDOS\EMM386.SYS 


BREAK = ON 
BUFFERS = 20 
FILES = 20 
FCBS = 4 


FASTOPEN = 512 

LASTDRIVE = E 

HISTORY = ON, 256, OFF 

COUNTRY 001,,C:\DRDOS\COUNTRY.SYS 


The display will vary according to your individual system setup. 
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9.3 Config.sys commands 


The config.sys commands are explained in detail on the 
following pages. Examples given under each command show 
how to set these parameters directly in the config.sys file. 
However, it is much easier to change your system configuration 
using the SETUP program. 


Command conventions 


The following conventions are used in the command 
descriptions: 


[] Square brackets indicate an optional part of the 
command line. Do not type the square brackets 
themselves, for example for [/C] you type /C. 


| A vertical bar indicates an either/or choice, e.g 
ON! OFF. Choose just one of the options and do 
not type the vertical bar. 


filename Indicates the full name of the file, including the 
filename extension. 


filespec Represents the location of the file in the 
subdirectory structure. When you type a 
filespec, each directory should be separated 
from the next by a backslash (\), and the last 
directory separated from the filename by the 
same symbol, for example: 
e:\drdos\command.com 


n Represents a number you type in. The values 
you can substitute are given in the command 
explanation. 


The config.sys commands are summarized in Table 9-1. Note 
that commands unique to, or extended under, DR DOS are 
indicated with an asterisk. 


Note 


DR indicates that the command is special to, or extended under, 
DR DOS. The config.sys commands are laid out on the page in 
a similar way to the commands in Chapter 8. Please refer there 
for an explanation of page layout if one is required. 
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Table 9-1 Config.sys commands 


Command Explanation 


? Conditional execution of commands. - 


BREAK Allows you to set the default state of the BREAK command 
which lets you stop a program while it is running. 


BUFFERS Sets the number of disk buffers DR DOS allocates. 
CHAIN Transfers control to another configuration file. i 


COUNTRY Selects the appropriate date and time format, 
currency symbol and code page parameter for your 


country. 

DEVICE Enables extra device drivers to be installed. 

DRIVPARM _ Sets the physical characteristics for a specified disk drive. 

ECHO Allows the display of messages on screen during * 
startup. 


FASTOPEN Increases the speed with which files are accessed when 
the same files are repeatedly used. 


FCBS Sets the number of files that can be opened by older 
applications at the same time. 


FILES Sets the number of files that can be opened by programs 
at the same time. 

HIDEVICE Allows device drivers to be installed, except the = 
specified device driver is loaded into upper memory. 

HIDOS Used to relocate as much of the DR DOS operating bs 
system into upper memory as possible. 

HIINSTALL Installs specified programs during startup into upper mn 
memory. 

HISTORY Provides extended line editing facility. ee 


INSTALL Allows you to load a program during startup. 
LASTDRIVE Sets the maximum number of drives to be accessed. 


REM During batch file execution eer the comment given on = 
the same line as REM. 
SHELL Specify the location of COMMAND.COM, or load a different 


command processor. 
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, 


Format 


? ["remark"] command 


Explanation 


If you insert a ? at the beginning of a statement in your 
config.sys file, when the commands in config.sys are executed 
you are asked if you want this particular command carried out. 
This is most useful when applied to the DEVICE= and CHAIN= 
statements so you can choose whether to install specific device 
drivers or transfer control to a different configuration file at 
startup. For example the following statement in your 
config.sys file: 


?DEVICE = C:\DRDOS\ANSILSYS 

means you are queried each time you reboot your system as to 

whether you want the device driver ANSI.SYS loaded, like this: 
DEVICE =C:\DRDOS\ANSI.SYS (Y/N) ? 

Type Y to load ANSI.SYS, N to ignore it. 


Alternatively you can place a message string between the 
question mark and the config.sys statement, enclosed in 
double quotation marks, for example: 


?"Do you want ANSI.SYS?"DEVICE = C:\DRDOS\ANSLSYS 


then at startup you are prompted with your message: 
Do you want ANSI.SYS? 


answer by typing Y for yes or N for No. This can be convenient 
if you have access to a network, you can set up a statement 
which prompts you at startup as to whether you want to use 
the network. 


Remarks 


You can use ? with any of your config.sys file statements. 


The maximum length allowed for a command statement 
including a question mark and message string is 128 
characters. Any statements longer than this are ignored. 
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BREAK 


Format 


BREAK = ON|OFF 


Explanation 


DR DOS allows you to stop a program when it is running by 
holding down the Ctrl key and pressing Break or C. The 
BREAK command lets you set checking to be on or off. 


If checking is OFF (the default) the key sequence Ctrl+Break 
or Ctrl+C will only stop the program when it next reads from 
the keyboard, writes to the screen or writes to a printer. 


When BREAK is ON, DR DOS also looks for Ctrl+Break or 
Ctrl+C when the program is reading to or writing from a disk. 


Remarks 


BREAK=ON lets you quickly stop programs that do not use 
standard input and output operations very often, such as 
programs that perform lengthy calculations before printing the 
final output. 


The BREAK command in the config.sys file can be overruled 
when you type a BREAK command from the DR DOS prompt. 
(See the BREAK command entry in Chapter 8.) 


Note 


Many applications disable this feature so that you can only use 
the method documented by the application to stop it. 
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BUFFERS 


Format 


BUFFERS = nn 


Explanation 


Buffers are small areas (or blocks) of memory that DR DOS 
uses during disk read or write operations. Buffers store the 
information that is being read or written. You can specify 
between 3 and 99 buffers; the default is 15 (if you have a 
640Kbyte system). 


Remarks 


The number of buffers you specify generally affects the speed at 
which a program accesses files. The more buffers there are, the 
faster the system accesses files. However, each buffer occupies 
memory that would otherwise be used for the program itself 
and for your data. If you specify a large number of buffers, your 
program may actually run slower than if you specify a small 
number. 


Your application documentation should suggest how many 
buffers you need. Between 10 and 380 is a sensible number; a 
few more may be needed if the program uses a large number of 
files. A desktop publishing program may need between 20 and 
30, for example. 


Example 


The following entry in your config.sys file sets the number of 
buffers to 20. 


buffers = 20 
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CHAIN 


Format 


CHAIN = filespec 


Explanation 


The CHAIN command transfers control to another 
configuration file. CHAIN checks that the filespec specified 
exists, if it does, it closes the current configuration file, and 
begins executing the statements in the filespec. It does not 
return to the original configuration file. 


Remarks 


The CHAIN command is most useful for systems with 
Read-only or ROM disks. It allows the user to change the 
default configuration specified in the ROM-based copy of the 
config.sys file. 


CHAIN is also useful when used in conjunction with the ? 
conditional option (see the entry for ?). Using it you can group 
together several similar config.sys commands into additional 
config.sys files, and execute them with one conditional 
statement. 


Caution 


When you use the CHAIN command to transfer control to a 
configuration file on a different drive, you must specify the 
full path including the drive in all DEVICE, and 
HIDEVICE statements. 


Example 


The following CHAIN command within a config.sys file, 
means that when DR DOS reaches the CHAIN statement it will 
look for a config.sys file on drive D: and if it exists, will begin 
to process the commands in that configuration file instead. If 
the config.sys file on drive D: does not exist, the original 
config.sys file continues to be processed. 


BUFFERS = 10 
COUNTRY = 44,,C:\DRDOS\COUNTRY.SYS 
CHAIN = D:\CONFIG.SYS 
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COUNTRY 


Format 


COUNTRY=nnn, cp, [d:] \path\COUNTRY.SYS 


Explanation 


The country.sys file provides the date and time format and 
currency symbol appropriate for your country. It also includes 
code page information which can be specified in the second 
parameter (cp). For European countries, for example, the 
preferred date format is day/month/year, whereas for North 
America it is month/day/year and for Japan, year/month/day. In 
the United Kingdom the currency symbol is £ rather than $ as 
used in the United States. 


The default value may already be set for your own country and 
may not need to be changed. 


The country code does not include information about the 
keyboard type; that information can be provided using the 
KEYB command, see Chapter 8. 


The country.sys file affects the commands: BACKUP, DATE 
RESTORE, and TIME. 


Options 

nnn The country code of your country. Table 9-2 
shows the values allowed. 

cp The code page for which country information is 


required. If this parameter is left out, the 
default code page for the country nnn is 
assumed. 


The first code page listed is the default code 
page for the country, see Table 9-2. 


9: Customizing your system 287 


Table 9-2 Country codes and code pages 


Country Code (nnn) Code Pages (cp) 
Australia 061 437 850 
Belgium 032 437 850 
Canada (French) 002 863 850 
Denmark 045 865 850 
Finland 358 437 850 
France 033 437 850 
Germany (West) 049 437 850 
Israel 972 862 850 
Japan 081 932 437 
Korea 082 934 437 
Italy 039 437 850 
Middle East 785 864 850 
Netherlands 031 437 850 
Norway 047 865 850 
Portugal 351 860 850 
Latin America 003 437 850 
Spain 034 437 850 
Sweden 046 437 850 
Swiss (French) 041 437 850 
Swiss (German) 041 437 850 
United Kingdom 044 437 850 
United States 001 437 850 
Example 


This entry in your config.sys file converts international 
currency symbols, date and time to Italian formats using code 
page 437. 


country = 039,437,C:\DRDOS\COUNTRY.SYS 
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DEVICE 


Format 


DEVICE = filespec [options] 


Explanation 


The DEVICE command enables device drivers to be installed. 
Device drivers for the keyboard, screen, disk drives, printer and 
auxiliary devices are automatically loaded as part of the DR 
DOS startup sequence. 


Whenever you add a new piece of computer hardware to your 
system like a printer or mouse, you should be supplied with a 
device driver if one is required. Device drivers are programs 
that are loaded alongside DR DOS to operate hardware devices 
which are not recognized as a default part of your system. 
Device drivers usually have the extension .sys. You need to 
copy the supplied device driver onto the disk from which you 
start DR DOS. Then use the DEVICE command in config.sys 
to ensure the driver is found and loaded each time DR DOS is 
started. 


A number of optional device drivers are supplied with DR DOS 
and can be loaded with the DEVICE command: 


ANSLSYS 
CACHE.EXE 
DISPLAY.SYS 
DRIVER.SYS 
EMM386.SYS 
EMMXMA.SYS 
HIDOS.SYS 
PRINTER.SYS 
VDISK.SYS 


These drivers are described in section 9.4. 
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Remarks 


If you precede a device statement with a question mark before 
the device driver is loaded, you are prompted as to whether you 
want it installed. This gives you the option every time you start 
DR DOS of omitting a particular device driver. 


Most device drivers are hardware specific, but some are 
designed for software functions like VDISK.SYS which is used 
to set up a memory disk on your system. 


Example 
The following statement installs the device driver ANSI.SYS. 
DEVICE = C:\DRDOS\ANSI.SYS 
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DRIVPARM 


Format 


DRIVPARM = /D:d [/C] [F:f] [/H:h] [/N] [/S:ss] [/T:tt] 


Explanation 


DRIVPARM sets the physical characteristics for a specified disk 
drive. It lets you associate a particular type of physical disk 
drive with a logical drive. For example, some computers do not 
expect to use 3 14" drives, so to add a 314" drive it may be 
necessary to use DRIVPARM to redefine the drive parameters 
for subsequent use by DR DOS. 


DRIVPARM is similar to the device driver DRIVER.SYS, except 
it only allows you to modify a logical drive already known to DR 
DOS. If you want to add a new logical drive, you must use 
DRIVER.SYS, see section 9.4. 


Options 

/D:d Asingle digit 0, 1, 2 and so on, which 
corresponds to the logical drive (for example A: 
or B:) for which the characteristics are to be set. 

[/C] Indicates that the drive is able to detect when a 
disk is changed in the drive. 

[F:f] Specifies the drive type. The possible values are 


0, 1, 2 and 7, where 0 = 360 Kbyte drive, 1 = 1.2 
Mbyte drive, 2 = 720 Kbyte drive and 7 = 1.44 
Mbyte. The default is 2. 


(H:h] Specifies the number of drive heads. Possible 
values are 1 and 2. 


[/N] Indicates that the drive is for permanent media. 

[/S:ss] Specifies the number of disk sectors that the 
drive supports. Possible values can be between 1 
and 63. 

[/T:tt] Specifies the number of tracks that the drive 


supports. Possible values are 40 and 80. 
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ECHO 


Format 


ECHO [message] 


Explanation 


ECHO allows the display of messages on screen during startup. 
You can display lines of text like this: 


ECHO Install code page switching? 
It is useful for including questions and explanatory messages 
as part of your config.sys file, and these messages are 


displayed at startup in the order they are inserted in the 
config.sys file. 


Remarks 


You can use ECHO in conjunction with the CHAIN command 
and the ? option. See the explanation for the CHAIN command. 
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FASTOPEN 


Format 


FASTOPEN = nnnnn 


Explanation 


FASTOPEN reduces the time taken to access files on a hard 
disk which are being repeatedly accessed. It does this by 
remembering the locations of the files on disk, so that DR DOS 
does not have to navigate along the path every time the file is 
opened. 


DR DOS sets up a special table of these filenames in memory 
and you can set the size of this table. 


The default number is 512. The minimum number is 128 and 
the maximum is 32768. 


Remarks 


This command improves disk performance at the cost of 
memory space. Each table entry uses 2 bytes of memory. 
Having a larger table than you actually need will not increase 
your system’s performance. 


Example 


This command sets up a table size of 512 entries: 
FASTOPEN = 512 
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FCBS 


Format 


FCBS=m,n 


Explanation 


This command sets the number of files that can be opened by 
programs at the same time, using data structures called File 
Control Blocks. FCBS have little effect unless the file sharing 
program SHARE.EXE (see Chapter 8), or networking support is 
loaded. 


Options 

m The number of files that FCBs can open at once 
in the range 1 to 255. 

n The number of files opened by FCBs that are 
protected from automatic closure by DR DOS in 
the range 1 to 255. (If an application attempts 
to open more than m files by FCBs, then all but 
the first n files may be closed by DR DOS.) 

Remarks 


Some older style applications may require you to insert an 
FCBS statement in config.sys rather than a FILES entry. (The 
configuration command FILES can also be used to control the 
number of files that can be opened simultaneously.) Unless 
your application documentation specifically requests you to 
have an FCBS entry, use FILES to control the number of open 
files allowed. 


Example 


This command sets the number of open files allowed to 8 and 
the number of protected files to 4. 


FCBS = 8,4 
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FILES 


Format 


FILES = nnn 


Explanation 


This command specifies the number of files that can be opened 
by programs at the same time. The default is 20 in the range 20 
through 255. DR DOS uses this number to determine how 
much memory to set aside for controlling open files. 


Remarks 


You should only increase the default if your application 
documentation instructs you to, or if the program you are using 
returns error messages that the number of open files is 
insufficient. 


Example 


The following entry in your config.sys file sets the number of 
open files allowed to 20. 


files = 20 
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HIDEVICE 


Format 


HIDEVICE = filespec 


Explanation 


The HIDEVICE command is identical to the DEVICE command 
in that it enables extra device drivers to be installed, except it 
attempts to load the device driver specified into upper memory. 
Before using HIDEVICE you must have a device driver which 
supports upper memory already loaded, for example 
EMM886.SYS. 


Using the MEM command with the /D switch, you can check 
whether there was enough upper memory available to load the 
device driver high, see Chapter 8. 


You can load the following device drivers into upper memory: 


ANSLSYS 

CACHE.EXE 

VDISK.SYS 

They are described in section 9.4. 

Device drivers which require more memory than the device 
driver image should not be loaded into upper memory using the 
HIDEVICE statement, because they cannot determine the 
amount of free memory available for their use. For example, 
VDISK.SYS must not be loaded unless the /E (Extended 
memory) option has been specified. 


Example 


The following command loads the ANSI.SYS device driver into 
upper memory. 


HIDEVICE =C:\DRDOS\ANSI.SYS 
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HIDOS 


Format 


HIDOS = ON|OFF 


Explanation 

The HIDOS statement is used to relocate as much of the DR 
DOS operating system data into upper memory as possible. The 
default is OFF. 


Note that a device driver which supports upper memory must 
be loaded first, for example EMM886.SYS or HIDOS.SYS. 
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HIINSTALL 


Format 


HIINSTALL = filespec [options] 


Explanation 


The HIINSTALL command is identical to the INSTALL 
command, except it attempts to load the program specified into 
upper memory. Before using HIINSTALL you must have a 
device driver which supports upper memory already loaded, for 
example EMM386.SYS. 


You can load the following programs using HITINSTALL: 


CURSOR.EXE 
KEYB.COM 
NLSFUNC.EXE 
GRAPHICS.COM 
GRAFTABL.COM 
PRINT. EXE 
SHARE.EXE 


[options] This indicates the options to pass to the 
program given in the filespec. 


Using the MEM command with the /D switch, you can check 
whether there was enough upper memory available to load the 
device driver high, see Chapter 8. 


Example 


The following command installs the KEYB program into upper 
memory, thus providing support for UK keyboards. 
HIINSTALL =C:\DRDOS\KEYB.COM UK 


Notice that you must give the full path to the program and its 
extension (.com or .exe). 
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HISTORY 


Format 


HISTORY = ON[,nnnn[,ON|OFF]] | OFF 


Explanation 


DR DOS provides an extended command line editing facility. 
This facility stores commands you previously issued in a 
memory buffer. You can then recall any previously entered 
commands and re-issue or modify them. If HISTORY is OFF 
the extended command line editing is disabled. If HISTORY is 
ON you can use the function keys described in Chapter 8, 
section 8.2 to recall and modify the command lines. 


Options 


nnnn Allows you to specify the size of the memory 
buffer in which the command lines are stored. 
The size of the memory buffer determines how 
many command lines you can recall. The 
minimum size you can specify is 128 bytes; the 
maximum size is 4096 bytes. If you do not 
specify one, a default size of 512 bytes is used. 


Note 

The system uses two memory buffers of the size 
you specify. The first memory buffer stores 
commands entered from the command line. The 
second memory buffer stores commands entered 
while running an application. 


[,ON| OFF] This sets the insert mode on or off. The default 
is off. If insert mode is on, characters are 
inserted in front of the cursor. If it is off, 
characters at the cursor position are 
overwritten. 


Example 


To switch on insert mode and set a memory buffer of 512 bytes: 
HISTORY = ON,512,0N 
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INSTALL 


Format 


INSTALL = filespec [options] 


Explanation 


The INSTALL command allows you to load a program during 
startup. You can install the following in this way: 


CURSOR.EXE 
KEYB.COM 
NLSFUNC.EXE 
GRAPHICS.COM 
GRAFTABL.COM 
PRINT. EXE 
SHARE. EXE 


[options] This indicates the options to pass to the 
program given in the filespec. 


Example 
The following INSTALL statement in a config.sys file, loads 
the KEYB program during config.sys processing. 


BUFFERS = 10 
INSTALL = C:\DRDOS\KEYB.COM UK 
FILES = 20 
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LASTDRIVE 


Format 


LASTDRIVE = drive letter 


Explanation 


DR DOS uses letters to identify particular drives. It 
automatically assigns a drive letter to each actual drive that it 
finds during the startup procedure (including any virtual disk 
drives). It then sets the last drive as being the drive letter 
assigned to the last drive it finds. All the remaining drive 
letters then become invalid. 


The LASTDRIVE command enables you to set a different last 
drive, so that DR DOS will recognize non-assigned drive letters. 


Example 


Suppose your computer has a diskette drive (drive A:), anda 
hard disk drive (drive C:). You have added two virtual disks 
(drives D: and E:) and you have a program that requires you to 
use the SUBST command with drives F: and G:. To use 
LASTDRIVE type LASTDRIVE followed by the highest drive 
letter you will need: 


LASTDRIVE = g 


This means that DR DOS recognizes drives F: and G: as well as 
drives A: through E:. 
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Format 


REM [comment] 


Explanation 


REM allows comments to be inserted into a config.sys file 
(REM is short for REMARK). 


Use REM with a comment to clarify what a command does or 
without a comment to add spacing for readability. 

Examples 

To clarify what an entry does: 


REM * Load the ANSI driver for Wordsmaster 
DEVICE = ANSI.SYS 
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SHELL 


Format 


SHELL = filespec [/E:nnnnn} [/P] 


Explanation 


Using SHELL you can specify what options the default DR 
DOS command processor COMMAND.COM will use and where 
it should be loaded from. (SHELL must be used if 
COMMAND.COM is located in a directory other than the root.) 
The command processor or “shell” as it is also known, carries 
out user commands and starts programs. 


You can also use SHELL to load a different command processor 
from the DR DOS default COMMAND.COM. (System 
programmers can write their own command processors and 
then use SHELL to load them.) 


Some of the most useful options to use with SHELL are listed 
below. See also the explanation of COMMAND.COM in Chapter 


8. 

Options 

/E:nnnnn Specifies the size of the environment in bytes 
where nnnnn is in the range 512 (minimum) to 
32,751 maximum). If you specify a value outside 
this range, the command defaults to the 
minimum value. 

/P Results in this copy of the command processor 


being fixed permanently in memory. The EXIT 
command is disabled. Also causes the 
autoexec.bat file to be executed when 
COMMAND.COM starts. 

The /P switch is mandatory if a SHELL 
statement is used, so that an EXIT command 
from the default shell COMMAND.COM will 
not exit from the COMMAND.COM and halt the 
system. 
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9.4 Installable DR DOS device drivers 


This section lists alphabetically the additional device drivers 
supplied with DR DOS; they are summarized in Table 9-3. 


Table 9-3 Installable device drivers 


Device driver Explanation 

ANSLSYS Provides extra options for the 
keyboard and screen. 

CACHE.EXE Allows you to set up an area of RAM 


memory to act as a buffer, storing a 
copy of data frequently read and 
written from disk, to speed up disk 


access. 

DISPLAY.SYS Enables code page switching to be 
used on EGA and VGA displays. 

DRIVER.SYS Sets the characteristics to be 


associated with a physical disk drive 
specified in the command line. 


EMM386.SYS Enables applications to use LIM 4.0 
expanded memory on Intel i386 and 
i486-based computers. Also allows 
upper memory to be appended to 
conventional memory during the 
execution of applications and device 
drivers, and BDOS to be relocated to 
upper, or high memory, to give more 
space in conventional memory for 
applications. 


EMMXMA.SYS Enables applications to use LIM 4.0 
expanded memory on 80286-based 
computers. 
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HIDOS.SYS 


PRINTER.SYS 


VDISK.SYS 


Note 


Supports the relocation of the DR 
DOS kernel to high memory on 
80286-based computers, and allows 
computers based on the Chips & 
Technologies LeAPSet, LeAPSetsx, 
NEAT, and NEATsx chip sets, to 
access a portion of upper memory. 


Enables code page switching on a 
printer. 


Sets aside a portion of RAM memory 
to act as if it was a very fast disk. 


The EMM386.SYS driver must always be loaded first and the 
VDISK.SYS driver after it (if it uses the /E option). The 
INSTALL and SETUP programs set this up automatically. 
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ANSI.SYS 


ANSLSYS is a device driver for the keyboard and screen. It 
provides extra options for programs that need to move the 
cursor, alter the screen display, or assign keyboard use. These 
options take the form of ANSI escape sequences which all start 
with the [Esc] character (1B hex). The ANSI.SYS driver can 
only detect escape sequences sent via the normal DOS function 
calls, and not character output performed using the ROM BIOS 
directly. 

Certain commercial applications that you run on your computer 
may expect ANSI.SYS to be present; refer to the application’s 
documentation. 


For programs to use ANSI escape sequences, the ANSI.SYS 
driver must be loaded. You can use the SETUP or INSTALL 
programs to do this automatically. Alternatively you can place 
the following command in the config.sys file: 


DEVICE = C:\DRDOS\ANSI.SYS 


This ensures that ANSI.SYS is loaded each time DR DOS is 
started. 


The general form of the ANSI escape sequence is: 
© Aone byte ESC character (hexadecimal 1BH). 
Aone byte [ character (hexadecimal 5BH). 


Oo 
One or more decimal numbers separated by semicolons. 
Ol 


Asingle command character. 
Below is a list of the ANSI escape sequences. Note: 


y, x indicate row and column numbers, which range 
between 1 and 50 rows (with 1 at the top of the screen) and 
1 and 79 columns (1 at the left of the screen). The numbers 
are specified in ASCII digits. If you omit the value (or 
specify zero), the default value is used. 


| 2| Spaces are shown only to make the sequences clearer to 
read. 


The sequences are divided into the following types: 


ul 


Cursor positioning 


a 


Erasing 


U 


Changing the display mode 
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Escape sequences for positioning the cursor 


Cursor position (CUP) ESC [ y;x H 
Horizontal and vertical position (HVP) ESC [ y;x f 


CUP and HVP position the cursor according to the co-ordinates 
issued. The default (and null) value is the top left corner of the 
screen. CUP and HVP are equivalent. 


Cursor up (CUU) ESC[yA 


Moves the cursor up y rows without changing columns. The 
sequence is ignored if the cursor is already at the top line. 


Cursor down (CUD) ESC [y B 


Moves the cursor down y rows without changing columns. The 
sequence is ignored if the cursor is already at the bottom line. 


Cursor forward (CUF) ESC[xC 


Moves the cursor to the right without changing rows. The 
sequence is ignored if the cursor is already in the far right 
column. 


Cursor backward (CUB) ESC [xD 


Moves the cursor to the left without changing rows. The 
sequence is ignored if the cursor is already in the far left 
column. 


Device status report (DSR) ESC [6n 
Console position report (CPR) ESC [ y;x R 


The DSR sequence instructs the console driver to return the 
CPR sequence. The CPR sequence reports the cursor position in 
terms of row and column. It is returned via the keyboard input. 
Save cursor position (SCP) ESC [s 

Restore cursor position (RCP) Esc [u 


SCP stores the current cursor position. RCP restores the cursor 
to that position. The default for RCP, if no SCP was issued, is 
0,0. These escape sequences cannot be nested. 
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Escape sequences for erasing 


Erase display (ED) ESC [2 J 


Erases the display and moves the cursor to the top left of the 
screen. 


Erase line (EL) ESC [ K 
Erases at the cursor position and to the end of the row. 


Escape sequences for changing the display modes 


Set graphics rendition (SGR) ESC [n;...;nm 


Sets various screen modes which remain until a different SGR 
sequence is set; screen modes are shown in Table 9-4. 


Table 9-4 Screen modes 


Parameter (n) Description 


0) Return to default (white characters on 
black background) 

1 High intensity (bold) 

4 Underscore (monochrome only) 

5 Flashing 

7 Inverse video (black characters on white 
background) 

8 Invisible (black on black) 

30 Black foreground 

31 Red foreground 

32 Green foreground 

33 Yellow foreground 

34 Blue foreground 

35 Magenta foreground 

36 Cyan foreground 

37 White foreground 

40 Black background 

41 Red background 
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Table 9-4 Screen modes (continued) 


Parameter Description 
42 Green background 
43 Yellow background 
44 Blue background 
45 Magenta background 
46 Cyan background 
47 White background 


Set screen mode (SM) ESC [=nh1 or ESC[=h1 or ESC [? 


nh 


Reset screen mode (RM) ESC [=n 1 or ESC [=1 or ESC[? 


nil 


These sequences set and reset the screen operating mode. (n) 
may take the values shown in Table 9-5. 


Parameter 


Noa p WN HF OO 


Table 9-5 Screen mode values 


Description 


40 x 25 monochrome 
40 x 25 color 

80 x 25 monochrome 
80 x 25 color 

320 x 200 color 

320 x 200 color 

640 x 200 monochrome 


Enables (SM) or disables (RM) wrapping at 
the row end. When this parameter is 
enabled, extra characters wrap on to the next 
line. When disabled, they are lost. 
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Assign a key (KR) ESC [n;n;...np 


Changes the function of a key. First define the key to be 
changed and then define the change. 


You can use extended character codes (ECCs) by typing the first 
variable in the sequence as 0 (NUL) followed by the second key. 
For example, 0;68; is the F10 key. The last variables are the 
character codes for the values you are assigning to the key. An 
alternative to the sequence of numbers is a string defined as 
characters enclosed in double quotation marks. For example, 
65;66;67 can be shown as “ABC”. 


Examples 
To position cursor at row 10, column 10, type: 
ESC [10;10H 


To set screen mode to 40x25 color, type: 
ESC [?1h 


To assign the F10 key to XDIR C:, type: 
ESC [0;68;"XDIR C:";13p 


To reset current attributes and then set green as foreground 
color on a white background, type: 


ESC [0;32;47m 
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CACHE.EXE 


This driver enables you to set up an area of memory to act as a 
buffer, storing a copy of data that is frequently read from disk. 
This area of memory is called a cache. Every time your 
applications attempt to access information on disk, a check is 
first made to see if a copy of the data is already in the cache. If 
it is, the copy is used instead which is much faster than 
accessing the disk itself. 

Caches can be very useful if your work involves applications 
that need to access the same data over and over, like a database 
or accounts program. 

You can install CACHE.EXE using the SETUP program or 
during installation. Alternatively, place a statement as follows 
in your config.sys file: 


DEVICE = C:\DRDOS\CACHE.EXE [options] 


Options 

/S=nnnn Buffer size in Kbytes (in the form /S=2048). This 
must be specified. 

[X Use expanded memory for buffers. 

/E Use extended memory for buffers. 

Remarks 


If you want to fine tune your cache, start with the largest 
possible memory size, and then after running a typical 
application (that is one of the applications you use often), note 
the use and hit rate figures by displaying the CACHE status 
report (you can do this by typing CACHE at the command 
prompt). Note that a cache hit is when the cache is accessed 
and valid data is found within. Repeat this process, reducing 
the memory allocated to the cache each time and then noting 
the new use and hit values. Continue until the memory size is 
reduced to its lowest value before the hit rate begins to drop. 
This will vary according to the disk and applications used. 
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CACHE can also be set up at the command line, see the 
explanation for the CACHE command in Chapter 8. 


Examples 


To install CACHE as a device driver using 1 Mbyte of extended 
memory for caching: 


DEVICE = C:\DRDOS\CACHE.EXE /E /S=1024 
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DISPLAY.SYS 


This driver enables code page switching to be used on EGA and 


VGA displays. 


To use this driver, place the following statement in the 
config.sys file. (This is done automatically if you use the 
SETUP program to install code page switching.) 


DEVICE=C:\DRDOS\DISPLAY.SYS CON=(type, hwcp,n) 


Options 


type 


hwep 


Example 


Defines the type of active display. Enter EGA for 
EGA, and VGA displays. If the parameter is 
omitted, DISPLAY.SYS checks the hardware to 
select the type of display in use. 


The hardware code page. DISPLAY.SYS cannot 
verify this parameter: if you are not sure what 
to enter, omit it. 


The number of additional code pages you want 
to prepare. Usually 1 (the hardware code page 
and 850) or 2. Amaximum of 12 is allowed. 
Memory is reserved for each code page reducing 
the amount of memory available to run 
applications. 


The following command defines the display type to be EGA, or 
VGA, using Code Page 437 and one additional code page, to be 
defined by the MODE command. 


DEVICE=C:\DRDOS\DISPLAY.SYS CON=(EGA, 437,1) 
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DRIVER.SYS 


DRIVER.SYS sets the characteristics to be associated with a 
physical disk drive specified in the command line. Use this 
device driver if you want to add a new logical drive of a 
different type to an existing DR DOS system (see also your 
hardware documentation). For example you may want to add a 
3 14" disk drive to a system which uses 5 14" drives. Note that 
this only applies if the computers’ internal ROMBIOS does not 
support 314" disk drives. The full command is: 


DEVICE =C:\DRDOS\DRIVER.SYS /D:n [/C] [/F:f] [/H:h] 
[/N] [/S:ss] [/T:tt] 


If you want to modify the characteristics of a logical drive 
already known to DR DOS use DRIVPARM, see section 9.3. 


Options 

/Dn Specifies the physical drive (for example 0,1,2) 
for which the characteristics are set. 

(/C] Indicates that the drive is able to detect when a 
disk is changed. 

(/F-£] Specifies the drive type. The possible values are 
0, 1, 2 and 7, where 0 = 360 Kbyte 5 4" drive, 
1 = 1.2 Mbyte 5 14" drive, 2 = 720 Kbyte 3 12" 
drive and 7 = 1.44 Mbyte 3 14 drive. The default 
is 2. 

[/H:h] Specifies the number of drive heads. Possible 
values are 1 and 2. 

[/N] Indicates that the drive is for permanent media. 

[/S:ss] Specifies the number of disk sectors per track 


that the drive supports. Possible values can be 
between 1 and 63. 


[/T:tt] Specifies the number of tracks that the drive 
supports. Possible values are 40 and 80. 
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Example 


For a 720 Kbytes 3 14" drive as the second drive, insert the 
statement: 


DEVICE = DRIVER.SYS /D:1 /C /F:2 /H:2 /S:9 /T:80 
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EMM386.SYS 


EMM386.8YS is an additional device driver for use on Intel 
i386, i386SX and i486-based computers, which allows DR DOS 
to make better use of the larger amounts of memory available 
on these computers. 


EMM386.SYS must be installed before any other drivers which 
use extended memory. 


The three main uses of EMM386.SYS are: 


Q To provide support for the LIM 4.0 Expanded Memory 
Specification (see Appendix C), without the need for special 
add-on memory cards. 


To allow upper memory to be used to load and execute 
applications and device drivers. 


Q To enable the operating system kernel to be relocated to 
upper, or high memory, to give more space in conventional 
memory for your own applications and data. 


Support for LIM 4.0 is optional; it may be the case that there is 
not enough contiguous memory within upper memory to 
provide the 64 Kbyte window necessary, or alternatively this 
feature may not be required. If LIM support is not enabled, all 
other features of the device driver are still available. 


The full command is: 


DEVICE = C:\DRDOS\EMM386.SYS [/FRAME=AUTO | NONE | nnnn]j 
[/KB=0|nnnn] [/AUTOSCAN=start-end] 
[/INCLUDE=start-end] [/EXCLUDE=start-end] [/VIDEO] 
[/BDOS=AUTO|FFFF |nnnn] [/USE=start-—end] 

[/ROM=AUTO | start-end] 


The easiest way to configure EMM386.SYS is to use the 
SETUP program (although if you prefer you can edit the 
config.sys file directly and insert a DEVICE = statement using 
the options described on the following pages). There are two 
EMM386.S8YS screens in SETUP. The first screen will be of 
interest to most users, it contains options to which you answer 
Yes or No. The second screen contains more advanced options. 
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The valid options for EMM386.SYS are listed below. Note that 
the keywords can be abbreviated to one letter, for example 
/FRAME=AUTO can be shortened to /F=AUTO. 


[/FRAME=xxxx] 
This option controls the LIM 4.0 emulation where xxxx can be: 


AUTO Performs an automatic search 
through upper memory for a free 64 
Kbyte window. It is the default. 


NONE Disables support for expanded 
memory (use it if you do not use 
expanded memory on your computer, 
but you want to take advantage of 
other features of EMM386.SYS). 


nnnn Specifies an address for the location 
of the 64 Kbyte window (provided 
there is 64 Kbytes of contiguous 
memory available at that address). 
For example /F=C000 forces the LIM 
window to be allocated at segment 
Co00h. If 64 Kbytes of contiguous 
memory is not available at the 
address specified, you will get a 
message reporting the conflict. 


[/KB = xxxx] 


This option controls the amount of memory to be used for LIM 
memory, where xxxx can be: 


0 Use all extended memory (the 
default). 
nnnn Use the specfied amount of memory. 


Note that this value must be given in 
decimal, whereas most of the other 
options are given in hexadecimal. 


[(/AUTOSCAN=start-end] 


This option automatically scans an area of upper memory to see 
if it can be used. By default, start is COOOH and end is FFFFH. 
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[INCLUDE=start-end] 


This option is similar to AUTOSCAN but using it you can tell 
EMM886.S8YS to use a portion of upper memory that would 
otherwise be ignored. The INCLUDE option uses less severe 
tests than the AUTOSCAN option, and can be used in place of 
AUTOSCAN, to test an area of upper memory which is known 
to be available. 


[/EXCLUDE=start-end] 


This option is the opposite to INCLUDE and can be used to 
specifically exclude an area of upper memory from the area 
being checked for usability. In this way an area of upper 
memory which AUTOSCAN incorrectly detects as being 
available, but is in fact being used by for example an 
application or network card, can be excluded. 


[/VIDEO] 


If your computer has an MDA, Hercules or CGA video adapter, 
then conventional memory may be increased by 64 Kbytes. This 
option can only be used on systems with a full 640 Kbyte of 
conventional memory which the /VIDEO option will then 
extend to 704 Kbytes. 


[/BDOS=xxxx] 


Relocates the DR DOS kernel, BDOS, freeing up space occupied 
for use by applications, where xxxx can be: 


AUTO Automatically scans upper memory 
for a contiguous area of 37 Kbytes of 
memory to map the kernel into. If no 
upper memory is found, then segment 
FFFF is used. 


FFFF Relocates the kernel to segment 
FFFF in high memory, freeing up 
more space for use by applications. 


nnnn Relocates the kernel to the specified 
address in upper memory. It will only 
work if 37 Kbytes of contiguous upper 
memory is available at this address. 
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[/USE=start-end] 


The /USE option is similar to the INCLUDE option, however it 
overides all the EMM386.SYS memory tests and makes the 
specified upper memory available. 


Caution 


The /USE option should only be specified by advanced users 
with experience of using and allocating upper memory. 


[/ROM=sstart-end] 


This option copies slow ROM into fast RAM. Then arranges for 
the RAM to have the same addresses as the ROM (that is, it 
maps the RAM over the ROM). This improves execution speed 
of ROM code. If no size is specified, the amount is determined 
from ROM headers, otherwise it is used as specified. 


[/ROM=AUTO] 


Copies all ROMs which can be found in the upper memory of 
the system to RAM. 


VCPI support 


VCPI (Virtual Control Program Interface) is now supported by 
EMM386.SYS. EMM386.SYS runs in protected mode in order 
to access certain features of the Intel i386 and i486 processors. 
EMM386.SYS can co-exist with other protected-mode programs 
that conform to the VCPI interface, for example LOTUS 1-2-3 
release 3, and Borland Paradox. Note that Microsoft Windows 
386 does not conformto VCPI, and so cannot be used with the 
EMM386.SYS driver. 


Note 


If you occasionally want to use the facilities of the 
EMM386.SYS driver, and at other times run MS-Windows/386, 
insert a ? in front of the DEVICE statement so that you can 
optionally load the driver. 


9: Customizing your system 319 


Examples 


The following command autoscans memory from C000 to FFFF 

(the default), but specifically excludes the area E800 to FFFF. 

No LIM page frame is set up, and the DOS kernel is also loaded 

high, if memory is available. 

DEVICE = C:\DRDOS\EMM386.SYS /F=NONE /B=AUTO 
/E=E800-FFFF 


(Note that all the options would be entered on the same line.) 


The following command specifies C400 as the address for the 
LIM window, with 2048 Kbytes of LIM memory to be used, and 
BDOS located to segment FFFF in high memory. Upper 
memory from C000 to FFFF is autoscanned. 


DEVICE = /FRAME-C400 /KB=2048 /BDOS=FFFF 

You would get a message like this displayed when you start up 
your computer: 

EMM386 V1.02 /frame=c400 /kb=2048 /bdos=ffff 
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EMMXMA.SYS 


EMMXMA.SYS is an additional device driver that enables 
applications to use LIM (Lotus, Intel, Microsoft) 4.0 expanded 
memory. This driver uses memory on cards compatible with 
IBM XMA memory expansion cards. This memory is mapped to 
a 64 Kbyte window that is positioned between the addresses 
CO00H and DFFFH. To use the device driver place the 
following line in the config.sys file: 


DEVICE = C:\DRDOS\EMMXMA.SYS [/FRAME=xxxx] [/KB=ddd] 


Options 


[/FRAME=xxxx] xxxx specifies the hexadecimal 
segment address of the start of the 
64Kbyte mapping window. If you omit 
this option, the driver searches 
automatically for a free 64Kbyte 
window between segment addresses 
CO00H and DFFFH. 


[/KB=ddd] Sets the total amount of memory to 
be allocated for LIM memory. The 
default value is to use all available 
memory. 


Example 


This specifies that the mapping window for LIM memory 
begins at hexadecimal address DO00H and 2096 Kbyte of 
memory is allocated for LIM use. 


DEVICE = C:\DRDOS\EMMXMA.SYS /FRAME=D000 /KB=2096 
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HIDOS.SYS 


HIDOS.SYS on an Intel 80286-based computer with extended 
memory can be used to relocate the DR DOS operating system 
kernel to high memory. 


This device driver also allows users with computers based on 
the Chips & Technologies LeAPSet, LeAPSetsx , NEAT and 
NEATsx chip sets, to access the upper memory between 640 
Kbyte and 1 Mbyte to load drivers, networking software, and 
TSRs (Terminate-Stay-Resident programs). This can be 
achieved using the HIDEVICE, HIINSTALL and HILOAD 
commands. 

To use the device driver place the following line (with the 
appropriate options) in the config.sys file: 

DEVICE = C:\DRDOS\HIDOS.SYS [/AUTOSCAN=start-end] 
[/INCLUDE=start-end] [/EXCLUDE=start-end] [/VIDEO] 
[/BDOS=AUTO|FFFF|nnnn] [/USE=start-end] 
[/ROM=AUTO|start-end] 


The valid options for HIDOS.SYS are listed below. Note that 
the keywords can be abbreviated to one letter, for example 
/VIDEO can be shortened to /V. 


[/AUTOSCAN=start-end] 


This option automatically scans an area of upper memory to see 
if it can be used. By default, start is COOOH and end is FFFFH. 


[INCLUDE=start-end] 


This option is similar to AUTOSCAN but using it you can tell 
HIDOS.SYS to use a portion of upper memory that would 
otherwise be ignored. The INCLUDE option uses less severe 
tests than the AUTOSCAN option, and can be used in place of 
AUTOSCAN, to test an area of upper memory which is known 
to be available. 
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Caution 


[/EXCLUDE=start-end] 


This option specifically excludes an area of upper memory from 
the area being checked for usability. In this way an area of 
upper memory which AUTOSCAN incorrectly detects as being 
available, but is in fact being used by for example an 
application or network card, can be excluded. 


/VIDEO] 


If your computer has an MDA, Hercules or CGA video adapter, 
then conventional memory may be increased by 64 Kbytes. This 
option can only be used on systems with a full 640 Kbyte of 
conventional memory which the /VIDEO option will then 
extend to 704 Kbytes. 


[/BDOS=xxxx] 


Relocates the DR DOS kernel, BDOS, freeing up space occupied 
for use by applications, where xxxx can be: 


AUTO Automatically scans upper memory 
for a contiguous area of 37 Kbytes of 
memory to map the kernel into. If no 
upper memory is found and extended 
memory is available, then segment 
FFFF is used. 


FFFF Relocates the kernel to segment 
FFFF in high memory, freeing up 
more space for use by applications. 


nnnn Relocates the kernel to mapped RAM 
in upper memory. It will only work if 
40 Kbytes of contiguous upper 
memory is available at this address. 


[/USE=start-end] 


The /USE option is similar to the INCLUDE option, however it 
overides all the HIDOS.SYS memory tests, and makes all 
specified upper memory available. 


The /USE option should only be specified by advanced users 
with experience of using and allocating upper memory. 
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[/ROM=start-end] 

This option copies slow ROM into fast RAM. Then arranges for 
the RAM to have the same addresses as the ROM (that is, it 
maps the RAM over the ROM). This improves execution speed 
of ROM code. If no size is specified, the amount is determined 
from ROM headers, otherwise it is used as specified. 


[/ROM=AUTO] 


Copies all ROMs which can be found in the upper memory of 
the system to RAM. 


Examples 


The following command relocates the operating system kernel 
on an Intel 80286-based computer with extended memory, to 
high memory. (Note that the operating system kernel can be 
relocated to high memory on any Intel 80286, i386 or 
1486-based computer.) 


DEVICE = C:\DRDOS\HIDOS.SYS /BDOS=FFFF 
The following command uses the Chips & Technologies NEAT® 
chip set support to map RAM into all available upper memory, 


except D000-DFFF. It automatically copies all ROMs, and 
relocates the BDOS, to upper memory. 


DEVICE = C:\DRDOS\HIDOS.SYS /EXCLUDE=D000-DFFF 
/ROM=AUTO /BDOS=AUTO 
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PRINTER.SYS 


This driver supports code page switching for printers. To enable 
code page switching on a printer, you need the following 
statement in the config.sys file. (The SETUP program will do 
this for you if you use it to set up code page switching.) 


DEVICE=C:\DRDOS\PRINTER.SYS LPTn=(type, hwcp,n) 


Also refer to your hardware documentation. 


Options 


LPTn 


type 


hwep 


Specifies the port on which the printer is 
connected. n is 1, 2, or 3. (PRN is equivalent to 
LPT 1 and can be used instead.) 


Each printer supporting code page switching 
must be defined. You can have up to three 
entries in the same DEVICE statement if there 
is more than one printer on your system. 


Specifies the printer you have. Use: 


4201 for the IBM 4201 Proprinter and IBM 
4202 Proprinter XL. 


4208 for the IBM Proprinter 4207 XL24 and 
4208 XL24. 


5202 for the IBM Quietwriter III. 
Or compatibles with the above. 


The hardware code page. This parameter can be 
omitted. 


The number of additional code pages that can be 
prepared for the printer. Usually 1 or 2, 
although a maximum of 12 is allowed. Memory 
is reserved for each code page, reducing the 
amount of memory available to run 
applications. (Separate areas of memory are 
used for printer and display information.) 
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Example 


The following command prepares two printers for use with an 
additional code page, for example 437. 


DEVICE=C: \DRDOS\PRINTER.SYS PRN=(4201, 437,1) 
LPT2= (5202, 437,1) 
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WARNING 


VDISK.SYS 


Using VDISK.SYS you can set aside a specified portion of your 
computer’s memory to act as if it were a fast disk. This area of 
memory is called a memory disk. 


Amemory disk has a very fast access time, but it is only in 
effect while your computer is switched on. When you switch off 
or reset your computer everything stored in a virtual disk is 
lost. This means that anything you have stored on it that you 
want to keep you must copy to a hard disk or diskette before 
switching off. 


VDISK.SYS can be useful for storing temporary files used by 
some programs, or by programs that need to access a lot of 
information quickly and often, like a database or spreadsheet. 


If you have extended memory, you can set up a virtual disk 
using the switches described below. Otherwise your virtual disk 
is automatically set up in conventional memory. 


The full command is: 
DEVICE = C:\DRDOS\VDISK.SYS [disk size] 
{sect size] [max no of files] [/E:sectors] 


Remember that any files stored on virtual disks are lost 
when the computer is switched off or when DR DOS is 
restarted. Any information you need to keep must be stored 
on diskette or on your hard disk. 


Options 


[disk size] Size of the disk in Kbytes. The default is 
64 Kbytes, and the range 1 through 256 Kbytes 
unless your system includes extended memory. 


[sector size] Specifies the smallest amount of space reserved 
on the disk. The default value is 128 bytes; 
alternative values are 256 or 512. 


[file number] The maximum number of files to be written to 
the root directory of the virtual disk and can be 
between 2 and 512; the default is 64. The 
number governs how much virtual disk space is 
reserved for the disk directory. Specifying a 
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large file number wastes space unless you plan 
to copy large numbers of files onto the virtual 
disk. 

[/E:sectors] This option is applicable if your computer has 
additional memory (called extended memory). 
The option locates the virtual disk in this 
extended memory. The sectors option defines 
how many sectors (1 through 8) are transferred 
at a time between ordinary memory and 
extended memory when the virtual disk is being 
used. The default is 8. 


Remarks 


VDISK must be installed before any other drivers which use 
extended memory are installed, but after EMM386.SYS which 
must always be loaded first. (The INSTALL and SETUP 
programs set this up automatically.) 


If VDISK.SYS is loaded into upper memory with the 
HIDEVICE command, then the /E switch must be used to 
create the memory disk using extended memory. 


Example 


The following command leads to a virtual disk of 200 Kbyte 
with a sector size of 256 bytes and a maximum of 32 files. 


DEVICE = C:\DRDOS\VDISK.SYS 200 256 32 
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9.5 The autoexec.bat file 


The autoexec.bat file is a batch file that DR DOS runs each 
time your computer is started. Autoexec.bat sets up your 
computer the way you want it. One is built up for you when you 
install DR DOS. Autoexec.bat must be stored in the root 
directory of the disk from which you load DR DOS (usually the 
hard disk). 


Below are some of the commands that can be put in or you may 
find already set up in your autoexec.bat file. The commands 
mentioned are discussed in more detail in Chapter 8. 


Note 


The DR DOS SETUP and INSTALL programs place two special 
labels in the autoexec.bat file :DRDOSBEG and 
:DRDOSEND. SETUP then processes anything between the 
two labels. Put any additional statements for DR DOS between 
these labels. Any other statements, for example for other 
operating systems, should be placed outside of the labels. 


KEYB 


The KEYB command tells DR DOS what kind of keyboard you 
are using. If you have a national keyboard (not the standard 
keyboard as used in the US) you need to run the KEYB 
command each time you start DR DOS, to ensure that the 
characters you type are the same as the characters displayed 
on the screen. 


PATH & APPEND 


The PATH command tells DR DOS where to look for command, 
program, and batch files. APPEND tells DR DOS where to 
search for any other type of file. 


You may want to put PATH and APPEND commands in the 
autoexec.bat file, tailored to your own directory hierarchy. 
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SET 


You can put the SET command into your autoexec.bat file. 
SET is a command which helps programs to carry out their 
work by inserting a string of information into the command 
processor’s environment. This string is then available to all 
programs and applications. 


TIME and DATE 


If your computer does not have a battery backed-up clock, you 
need to set the system date and time at startup using the DR 
DOS commands TIME and DATE. These commands prompt 
you to type in the correct time and date, and then they set the 
system clock for you. If you include TIME and DATE in the 
autoexec.bat file, you are prompted to set the system clock each 
time DR DOS is started. 


Note 


If your computer has a battery-backed up clock, DR DOS reads 
this automatically on startup. 


PROMPT 


You can put a PROMPT command into your autoexec.bat file. 
PROMPT allows you to change the default DR DOS system 
prompt. For example you can replace the familiar prompt with: 
Have a nice day! 

or (more usefully) show the current directory, such as: 
C:\william\wundawrd\reports> 

You can change the prompt whenever you like, but again you 
may prefer to do this automatically each time DR DOS is 


started, by using the autoexec.bat file. The PROMPT 
command is described in Chapter 8. 
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Starting applications from autoexec.bat 


Another way the autoexec.bat file can be useful is to 
automatically load your favorite software. Suppose you have a 
word processor called WundaWord which is run by typing ww 
from a directory called \wundawrd. Normally you would need 
to type two commands to start WundaWord: 


C>CHDIR \wundawrd 
and then: 
C>ww 


You can put both these commands in the autoexec.bat file, so 
that WundaWord is loaded each time you start the computer. 


An example autoexec.bat file: 


KEYB UK 

DATE 

TIME 

CD \wundawrd 

ww 

cD \ 

where: 

KEYB UK Tells DR DOS your computer has a 
UK keyboard. 

DATE 

TIME Prompts you to type in the date and 
time. 

CD \wundawrd Makes \wundawrd the current 
directory. 

WW Starts WundaWord. 

CD \ Returns you to the root directory 


when you leave WundaWord. 


setting up code page 
switcning 


D* DOS allows you to use the range of characters required in a number 
of national languages, by interpreting the different language-specific 
characters using a mechanism called code page switching. 


Usually you only need to set your computer up for code page 
switching if you: 


| 


| 


| 


write documents which are to be used on a computer in a 
different country. 


receive foreign language documents in which some letters 
become unintelligible characters when displayed or printed. 


are using an application that is difficult to read on the 
screen because some graphics characters, such as boxes, 
appear as letters. 


If you do not meet any of these situations, you probably do not 
need to use code page switching, or to read the information in 
this chapter. 
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10.1 What does code page switching mean? 


Character sets 


Definition of a code 
page 


Hardware code page 


When you press a key on a keyboard (a letter, symbol or 
number) the computer receives a numeric code that represents 
the way in which that keystroke is to be displayed, printed and 
stored. 


Up to 256 codes are available to represent lower and upper case 
letters, numbers, punctuation marks and all the mathematical 
symbols on your keyboard. This may seem to be more than 
enough, but it is not possible to represent all the letters and 
characters used in every language in one character set of 256 
codes. For example: 


(1 Some languages have a much larger alphabet than others 
and include many accented characters. On most keyboards 
these accented characters are produced by adding extra 
single keystroke characters. These key combinations are 
known as dead keys. 


1 Many graphics characters such as||_and[| can be entered. 


To accommodate these differences, a number of character sets 

are available. The numeric code entered when you press a key 
represents a different character depending on which character 
set is in use. 


The most common character set (known as 437) caters for 
several languages including English, German and French. 
Character sets 865 and 860 contain the characters needed for 
Danish and Portuguese respectively. In these character sets, 
some symbols available in 437 have been removed to make 
room for the extra letters needed. For example, the code for f 
(franc) has been used for O in 860. 


The character sets are stored in a table called a code page. DR 
DOS allows you to change the code page that your computer 
uses, so allowing you to view in its original form a document 
created using a different code page. Appendix B lists the 
characters available from the different code pages. 


The hardware code page is the standard code page built into 
your computer. Additional code pages are provided in the Code 
Page Information or .cpi files in your software, for example 
Code Page 860 for Portugal. Table 10-1 shows the national 
prepared code pages supported by DR DOS. There is also an 
international code page, Code Page 850, that can be used in any 
of the countries (see Table 10-1). 


10: Setting up code page switching 333 


Table 10-1 National prepared code pages 


Country Code pages used 
Australia 437 850 
Belgium 437 850 
Canada (French) 863 850 
Denmark 865 850 
Finland 437 850 
France 437 850 
Germany 437 850 
Israel 862 850 
Italy 437 850 
Middle East 864 850 
Netherlands 437 850 
Norway 865 850 
Portugal 860 850 
Latin America 437 850 
Spain 437 850 
Sweden 437 850 
Swiss (French) 437 850 
Swiss (German) 437 850 
United Kingdom 437 850 
United States 437 850 


Code Page 850 


To simplify the exchange of computerized documents between 
countries, the International Standards Organization (ISO) 
defined a new code page called 850, for use across national 
boundaries. This standard, ISO 8859/1, can be used instead of 
local code pages and reduces the need for code page switching 
because the sender and the recipient always use the same code 


page. 
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Limitations of Code Page 850 


In Code Page 850 it was not possible to keep the original code 
for every character in every local code page. For example, two 
characters in 437, the Yen ¥ and Cent ¢ signs, have been moved 
and some graphics characters have been removed to make room 
for characters frequently used in the other languages. 
(Appendix B shows the contents of the five code pages supplied 
as standard with DR DOS.) 


In most cases you should be able to use either your local code 
page or the international Code Page 850, but there may be 
occasions when you need to switch code pages while you work. 


Some applications are written specifically for Code Page 437, 
especially those that use line-drawing characters. These 
applications may produce displays which are difficult to read 
when run under Code Page 850. Typically graphics corners and 
joints become accented letters. 


The following is an example of a display that was intended for 
use in Code Page 437 and how it looks in Code Page 850. 


a | 
E ¢g 
Code Page 850 Code Page 437 


If you are running an application that uses line-drawing 
characters that are not available in the code page delivered on 
your computer, run the application under the code page in 
which it was written. By switching to the original code page, 
you get a display that is easier to read. 


IN summary 


) Ifthe local code page is not supported by your hardware, you 
can use code page support to remedy this. 


QO Ifyou need to work in more than one language, use Code 
Page 850 for all new work. 


Q Ifyou receive a document in a language that was created in 
a local code page, use that code page. If your local language 
is not covered by a specific code page, use Code Page 850. 
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Q Ifyou use an application that was written for a particular 
code page, or that uses line-drawing characters, use the code 
page that it was written in. 


Hardware supported 


DR DOS supports code page switching on EGA and VGA 
displays and on the following printers: 


IBM Proprinter (4201) & Proprinter XL (4201) 

OQ IBM Proprinter X24 (4207) & XL24 (4208) 

QO IBM Quietwriter ITI (5202) 

Q Printers compatible with the printers listed above 


0) 


10.2 Setting up for code page switching 


You can set up your system initially to allow code page 
switching either when you install DR DOS or later using the 
SETUP program (see Chapter 9). Hither way you configure 
your system to use code page switching simply by answering a 
few questions. You need to: 


QO say that you want code page switching. 


Q define which printer(s) will be configured for code page 
switching if required. 

Q gelect the code page DR DOS is to use as the default (that is, 
the one that will be active when the computer is switched 
on). 


Just follow the on-screen prompts provided. 


When you finish installation make sure all printers supporting 
code page switching are switched on and online before you 
reboot your system. 


When you set up code page switching certain commands are 
automatically placed in the config.sys and autoexec.bat files 
reflecting the parameters that you selected. The keyboard, 
display and printer are set up to use code page switching each 
time the system is turned on. Fonts for the default code page 
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(which are held in the .epi files) are downloaded to all the 
devices that support code page switching. 


10.3 Example config.sys and autoexec.bat 
files 


This section provides an example of a config.sys file and 
autoexec.bat file for a system with one printer set up to use 
Code Page 850 as the default code page. 


Note 


The hardware code page (that is the character set available as 
standard with your computer), is always prepared for use. The 
INSTALL program and SETUP configure your system to allow 
one alternative code page. The example files described in this 
section are set up to allow you to switch from Code Page 850 to 
the hardware code page simply by entering the CHCP (Change 
Code Page) command at the command prompt (see section 10.4 
for a description of CHCP). 


A brief explanation of the commands is given below the 
example. There is a detailed description of all the parameters 
in Chapters 8 and 9. 


Example config.sys file 


SHELL = C:\DRDOS\COMMAND.COM /P /E:512 


BREAK = ON 
BUFFERS = 15 
FILES = 20 


FASTOPEN = 512 

LASTDRIVE = E 

HISTORY = ON, 256 

COUNTRY = 044, 850,C:\DRDOS\COUNTRY.SYS 
DEVICE = C:\DRDOS\DISPLAY.SYS CON=(EGA,,1) 
DEVICE = C:\DRDOS\PRINTER.SYS LPT1=(4201,,1) 


COUNTRY.SYS, PRINTER.SYS and DISPLAY.SYS are the 
drivers that support code page switching. 
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COUNTRY 


Sets up the country information. The code page parameter 
allows the system to convert characters from upper to lower 
case correctly (and vice versa) and to sort them in the correct 
order. 


When you set up your system for a national language, DR DOS 
checks the screen, printer and keyboard codes you asked for to 
see if they will work together. The valid combinations of 
prepared code pages, country and keyboard codes are defined 
using the KEYB command and country.sys file. See the 
entries for these commands in Chapters 8 and 9 for the valid 
code combinations. 


DEVICE 


Loads the driver for the display/printer. The drivers define the 
number of code pages (in addition to the hardware code page) 
that can be used (1 in the example). Memory is set aside for 
each of these code pages reducing the memory available to run 
applications. Therefore although the maximum is twelve, using 
a smaller number is more efficient. 


Example autoexec.bat 


@ECHO OFF 

PATH C:\DRDOS 

VERIFY OFF 

KEYB UK+, 850 

MODE CON: CODEPAGE PREPARE=((850) C:\DRDOS\EGA.CPI) 
MODE LPT1: CODEPAGE PREPARE=((850) C:\DRDOS\4201.CPTI) 
NLSFUNC 

CHCP 850 


KEYB, MODE, NLSFUNC and CHCP are the commands that 
support code page switching. 
KEYB 


Sets the keyboard nationality and the code page that will be 
used for the keyboard. 
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MODE device PREPARE 


Prepares a code page for a display or printer. Code pages must 
be prepared before they can be selected. Several code pages can 
be prepared for one device in one statement, the maximum 
being the number defined in the DEVICE = statement. 


You do not need to prepare the hardware code page. Note that 
there are other MODE code page options, see the next section. 


NLSFUNC 


Provides support for extended country information and enables 
you to use the CHCP command to select code pages for all 
devices set up to use them. 


CHCP 


Selects a code page for all the devices that are set up for code 
page switching. In the example, 850 will be the active code page 
when the system is turned on. The keyboard, display and 
printer will be set up for Code Page 850. 


10.4 Working with code pages 


Changing between code pages 


Loading the NLSFUNC 


utility 


When you have set the system up for code page switching, it is 
simple to switch from the default code page to any other that 
was prepared (that is, the hardware code page and any other 
code page defined in a MODE PREPARE command). You do 
this using the CHCP command. 


However, before you can use CHCP, the utility NLSFUNC must 
be loaded. This can be done at installation. Typing NLSFUNC 
on its own at the command line loads the utility if it is not 
already installed. 


To change the code page on all devices, from the command 
prompt type: 


CHCP cp 
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where cp is the number of the code page that you want to use 


now. When the operation is complete, the command prompt is 
returned. 


The code page is changed on all the devices (displays, 
keyboards and printers) that were defined as supporting code 
page switching in the config.sys file. 


Note 


All printers supporting code page switching must be switched 
on and be online when the CHCP command is used. The system 
may take some time to report an error if the printer is not 
switched on or is off-line. 


Using MODE SELECT 


Changing a code page 
temporarily 


You can use the MODE SELECT command to change the code 
page on a single device. If you do this, however, you will find 
that the country information and some other information used 
by the device is set up differently to the rest of the system. 

You may find the MODE SELECT command useful if you want 
to change a code page temporarily on only part of the system. 
For example, you may want to display a document in a local 
code page without printing the document. 


Listing your current code pages 


You can display currently prepared and selected code pages for 
screens or printers using the MODE command as follows: 


C>MODE device CODEPAGE [/STATUS] 


The selected code page number is displayed, followed by a list of 
hardware code pages defined in the config.sys file and code 
pages prepared using the MODE PREPARE command. 


For example if you type: 
C>MODE lIpti1 cp 
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You see a display similar to this: 
Active codepage for device LPT1 is 850 


hardware codepages: 
codepage 437 
prepared codepages: 
codepage 437 
codepage 850 


Completed codepage status function 


For more information see Chapter 8. 


Refreshing lost code pages 


If you select a code page for a printer, then turn the printer off, 
the code page information may be lost. If this happens, you can 
reload the fonts for the active code page on to the printer by 
using the MODE CODEPAGE REFRESH command: 


C>MODE device CODEPAGE REFRESH 
For example: 


C>MODE lpt1 CODEPAGE REFRESH 


refreshes the code page on the printer connected to port LPT1. 
For more information see Chapter 8. 


Error messages and 
troubleshooting 


lia appendix is divided into two sections: 
<) A.1 Error messages. An explanation of the DR DOS error 
messages. 
Q A.2 Troubleshooting. What to do if you have problems. 
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A.1 Error messages 


This section lists DR DOS error messages in alphabetical order, 
giving the origin of the message followed by an explanation of it 
and where possible, suggestions for correcting the error. At the 
end of the section is a separate list of the SID debugging tool 
error messages. 


If an error message is not listed here, it is probably generated 
by one of your applications; consult your applications’ 
documentation. 


Note that all DR DOS external commands have a /H(elp) option 
which displays a screen of help text on the command, see 
Chapter 8. 


Reformatting 


In some cases this appendix suggests reformatting and/or 
repartitioning as a remedy for some hard disk error conditions. 
Keep in mind that such action is an extreme corrective measure, 
because it destroys ALL the files within the partition. If 
possible, back up all the files within the partition first. 


Performing a system reset 


Error conditions that require you to perform a system reset, by 
pressing Ctrl+Alt+Del, are rare. If such a condition occurs 
make every effort to leave your program normally before 
resetting your system. If you have no alternative but to reset 
your system, try to close any open files before doing so. 


Abort, 


Access 
Access 
Access 
Access 


A: Error messages and troubleshooting 343 


Retry, Ignore, Fail ? 


Origin 
Explanation 


denied 
denied for file 


Several commands 


Typically this message follows an error in a read 
or write operation. You can respond by typing A, 
R, Tor F. 


If the reason for the error is obvious (such as no 
diskette in the target drive) then correct the 
error and type R to try again. A (for abort) stops 
the current operation. I results in the next stage 
of the current operation continuing, as if the 
error had not been detected. F lets the current 
operation know that there is an error, and it 
may therefore continue or stop. In both the last 
two cases there is a risk of data being corrupted. 


denied on source directory 
to fille «.. denied 


Origin 
Explanation 


Several commands. 


The file is probably either a read-only file or a 
password-protected file. 


Read-only files can be changed to read-write via 
the ATTRIB command. To access a 
password-protected file you need to type the 
filename followed by a semicolon and then the 
password. 


Attribute A,H,R or S expected to follow 


Origin 
Explanation 


ATTRIB, XCOPY 


You need to name the attribute explicitly when 
you type the command line. 


Retype the command line and include a letter to 
name the attribute. You can find out what the 
letters stand for by typing the command name 
followed by the /H(elp) option. 
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BACKUP file sequence error 


Origin RESTORE 


Explanation You have probably inserted a diskette from the 
wrong set of diskettes. If you have two sets of 
backup diskettes you may have restored from 
diskette 1 in the first set and then tried diskette 
2 from the second set. 


Try again with the correct diskette. 


Bad command or parameter; press ? for help 


Origin SID 


Explanation You have typed an incorrect command line. If 
you enter ? you will get a list of the valid SID 
commands. Typing ?? gives a more detailed 
listing with command syntax. 


Bad file name 


Origin SID 


Explanation A filename in an E, R, or W command is 
incorrectly specified. 


Bad media type 


Origin Any application 


Explanation The diskette you have inserted into the 
diskette-drive is not of the expected format. 


Try another diskette. 


Bad or missing file 


Origin DR DOS startup procedure. 


Explanation DR DOS either cannot find or cannot read the 
config.sys file on the root directory of your 
startup disk. 


Alter the config.sys file and then restart DR 
DOS. See the description of config.sys in 
Chapter 9. 
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Batch file ... missing retry (Y/N)? 


Origin Batch files 

Explanation DR DOS was unable to find the batch file that it 
was in the midst of processing. The batch file 
may have been deleted by one of the commands 
it contained. 


Check your backup copy and correct the 
command that caused the problem. 


Batch files nested too deep 


Origin Batch files 


Explanation One batch file can be called from within another 
batch file using the CALL command. The first 
batch file is then said to be nested within the 
second. This error message tells you that too 
many CALL statements have been made within 
the file. 


Check the batch files and correct the command 
causing the error. 


Binary reads from a device are not allowed 


Origin COPY 
Explanation You have attempted to copy from a device using 
the binary switch /B. 


Re-enter the COPY command without the /B 
switch. See Chapter 8 for a full explanation of 
the COPY command. 


Cannot access drive 


Origin BACKUP 


Explanation The target disk may not be inserted correctly, or 
it may be corrupt. 


Cannot close 


Origin SID 


Explanation The disk file written by a W command cannot be 
closed. 
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Cannot copy to/from a reserved device 


Origin REPLACE 


Explanation REPLACE cannot be used to copy files to 
devices such as modems or printers. 


Use the COPY command or the PRINT 
command if either of these are appropriate. 


Cannot open ... (device) 


Origin FIND 


Explanation The FIND command cannot be used with 
devices. It is only used with files kept on disk. 


Use the COPY command to copy the relevant 
files to disk first, and then perform the FIND. 


Cannot XCOPY to/from a reserved device 


Origin XCOPY 


Explanation You have attempted to XCOPY to a device such 
as a modem or printer. XCOPY should only be 
used for copying to disks. 


Use the COPY command instead. 


Can’t load DOS file 


Origin DR DOS startup procedure 
Explanation The file may be missing or corrupt. 


Start DR DOS from your startup diskette. You 
will then need to copy the system files from that 
startup diskette back to the hard disk or 
diskette that failed. You can do this with the 
FDISK command (for a hard disk) or the 
FORMAT command (for diskettes). Remember, 
however, that both these commands erase the 
information already existing on the disk. See 
the descriptions of FDISK and FORMAT in 
Chapter 8. 
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CGA display adapter not found 


Origin MODE 


Explanation You have specified a mode display option that is 
not relevant to your computer. 


Codepage not prepared 


Origin MODE PREPARE 


Explanation You have specified an additional code page in 
the DEVICE command but have not prepared it 
yet. 


To prepare the code page use the MODE 
PREPARE command (see Chapter 8). Include 
the code page in the cplist parameter. 


Codepage operation not supported on this device 


Origin MODE PREPARE 


Explanation: DISPLAY.SYS or PRINTER.SYS is not installed 
for this device. 


Add or correct the DEVICE statements in the 


config.sys file using the SETUP program, or by 
directly modifying config.sys. 


Command or file name not recognised 


Origin Any command 
Explanation You have typed an invalid command. 


Check the spelling (Chapter 8 section 8.2 
explains how to recall, edit and reissue 
commands) and re-enter the command or read 
Chapter 8 for a full list of valid DR DOS 
commands. Also check the path to ensure that 
the required program, if correctly spelt, should 
be found. 
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Could not create new volume label on destination disk 


Origin BACKUP 

Explanation The disk is probably physically write-protected. 
Remove the write-protection, see Chapter 1, 
section 1.1. 


Could not delete destination disk volume label 


Origin BACKUP 
Explanation The disk is probably physically write-protected. 


Remove the write-protection, see Chapter 1, 
section 1.1. 


Could not load FORMAT 


Origin BACKUP 


Explanation FORMAT.COM is the file containing the DR 
DOS FORMAT command. BACKUP tried to run 
FORMAT because it detected that the target 
diskette was unformatted. 

Ensure that the two files BACKUP.COM and 
FORMAT.COM can both be accessed by DR 
DOS before you repeat the command. Ona 
diskette-only computer this may mean having 
both files present on the same diskette in the 
drive. Alternatively repeat the BACKUP 
command with a blank formatted disk in the 
target drive. 


Could not update destination disk backup file 
Could not update destination disk control file 


Origin BACKUP 
Explanation Your disk may be corrupted. 
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en 


Could not update log file 


Origin BACKUP 


Explanation The BACKUP log file (if you have chosen to 
create one) is kept on the root directory of the 
disk from which you start DR DOS. If you have 
started DR DOS from diskette, make sure the 
diskette is in the current drive. 


Current keyboard does not support this codepage 


Origin MODE SELECT 


Explanation The code page is still selected, but this message 
is displayed as a warning if the MODE SELECT 
command was used before the country has been 
changed on the keyboard with the KEYB 
command. The display and keyboard are 
therefore using different code pages. (The 
keyboard code page is changed automatically, 
but the country must be changed using the 
KEYB command.) 


Use the KEYB command to set the new country 
for the keyboard, for example KEYB UK+,437 
(see Chapter 8). 


Current path invalid 


Origin FIND 
Explanation Retype the command with the correct path. 


Cyclic copy not allowed 
Origin XCOPY 


Explanation You have attempted to copy subdirectories using 
the /S switch. However, some of the 
subdirectories that would be copied are named 
as the target directories to receive the copy. 


Copy to different directories, or to a different 
drive. 
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Data error 


Origin 
Explanation 


Date is not valid 


Origin 


Explanation 


Any application 
There is an error accessing the device specified. 


Check the device (for example make sure it is 
connected properly). If the device being accessed 
is a disk drive (hard or diskette), this error 
implies that data on the disk is corrupt. Make 
backups of all non-corrupt files on the disk, and 
then either reformat the disk, or use a different 
disk. 


BACKUP, RESTORE 


The command cannot be executed with the date 
you have specified. The date may be typed 
wrongly, or it may be in the wrong format. 
Retype the command with a valid date. You may 
find the DR DOS DATE command helpful. 
Using it you can display the DR DOS current 
date in the preferred format. 


Date must also be specified 


Delete failed 


Origin 
Explanation 


Origin 
Explanation 


BACKUP 


You need to include the relevant date when you 
specify a time in BACKUP. 


XDEL 


Some or all of the files may be 
password-protected or read-only. 


See the descriptions of PASSWORD and 
ATTRIB in Chapter 8 for details of handling 
protected files. 
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Destination disk is full 
Origin RESTORE 
Explanation There is no further room for files on this disk. 
Restore the files to a different disk. 


Destination file content lost during copy 


Origin COPY 


Explanation You have used the + feature within COPY to try 
to concatenate a file onto itself. 


Copy the original file to a different filename. 
Then use the + feature to create a new file 
made from the original file concatenated with 
the renamed copy. 


Destination must be a valid disk drive 


Origin BACKUP 


Explanation Valid drives are the physical diskette and hard 
disk drives. The destination drive must be 
different from the source drive. 


Retype the command with the correct drives. 


Destination path not found 


Origin BACKUP, RESTORE 


Explanation You have probably mistyped the path. Try 
typing the command path again. 


Try again. 
Device error during 
Origin MODE PREPARE, REFRESH, SELECT, or 
STATUS command 


Explanation The printer was off-line or not switched on 
when the command was given. 


Check the printer status before re-entering the 
command. 
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Disk drives or diskette formats are incompatible 


Origin 


Explanation 


Disk fai 
Origin 
Explanation 
Disk read error 
Origin 
Explanation 
Disk write error 
Origin 


Explanation 


Drive not ready 
Origin 


Explanation 


EMM386: Invalid options 
Origin 


Explanation 


DISKCOMP 


The two types of diskette to be compared are not 
the same. For example, you may be trying to 
compare a 1.2Mbyte diskette with a 360Kbyte 
diskette. 


Any command 


Erase some unwanted files from your disk and 
try again. 


SID 


The disk file specified in an R command could 
not be read properly. 


SID 


A disk write operation could not be successfully 
performed during a W command, probably due 
to a full disk. 


Any command 


The diskette is not correctly in the drive, or the 
drive door is still open. 


Or parameters specified.... 


The config.sys file in the root directory of your 
startup disk. 


You have incorrectly specified the DEVICE = 
EMM386.SYS statement in the config.sys file. 


Retype the statement in the config.sys file. The 
error message includes information about the 
correct usage. (You can use the SETUP program 
to install EMM386.SYS device driver.) 
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EMM386.SYS Requires an Intel 80386 


Origin The config.sys file in the root directory of your 
startup disk. 


Explanation You cannot load the EMM386.SYS device driver 
on this computer. This device driver requires an 
Intel i386, i486 or compatible processor. 


EMM386: The driver can’t install as there is no extended 
memory (above 1Mb) in this machine 


Origin The config.sys file in the root directory of your 
startup disk 


Explanation You cannot load the EMM386.SYS device driver 
on a computer that does not have extended 
memory. 

EMM386: The driver can’t install as there is no unused 
64Kb range available for memory management 


Origin The config.sys file in the root directory of your 
startup disk. 


Explanation DR DOS is unable to find enough free memory 
to load the EMM3886.SYS device driver, and 
provide a LIM window. Try again with the 
option /FRAME=NONE, see Chapter 9. 


Environment error 

Origin SET 

Explanation DR DOS cannot find the current environment 
and so cannot change it. 


Environment full 


Origin SET 


Explanation You have probably tried to add one too many 
variables to the environment. 


Display the current variables by typing the SET 
command without any options, and then delete 
any environment variables that you do not need. 
See the description of SET in Chapter 8. 
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Error on file 


Origin PRINT 


Explanation PRINT has discovered an error in a file that it 
was trying to print. 


Attempt to recover the file to a different area of 
the disk. 


Error reading configuration file 


Origin FILELINK 


Explanation Your configuration file cannot be processed. 
Check that the format of the file is correct. 


Error reading filelist 


Origin Several commands 


Explanation The "filelist" file you specified cannot be 
processed. 


Check the format of your filelist. It must be in 
ASCII text format, use EDITOR to create it, not 
a word processor. Each filename in the list must 
begin on a new line. If you still have problems 
check the integrity of your disk using CHKDSK. 


Error reading from standard input 


Origin SORT 
Explanation Standard input could not be read. 
Check your source file or device for errors. 


Error reading system. area 


Origin FDISK 
Explanation This message implies a hardware failure. 


Contact your dealer. 
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Error reading system files 
Error writing system files 


Origin FORMAT, SYS 
Explanation Format has been unable to copy system files to 
a newly-formatted disk. 


Check that the drive door is closed. If it is you 
may have a defective diskette. 


Failed to change mode of printer 


Origin MODE 
Explanation A MODE change could not be carried out on the 
printer. 


Check that the printer is connected properly, 
and is online. 


Failed to get current path on drive...(OS error code ...) 


Origin Several commands 


Explanation This is probably an error on the disk in the 
drive mentioned or a problem with the disk 
drive itself. 


Consult your dealer. 
Failed to set default system password 


Origin PASSWORD 


Explanation Ifyou get this error message, make a note of the 
situation in which it occured and contact your 


dealer. 
File already open 
Origin ATTRIB, PASSWORD, REPLACE, XCOPY, 
XDIR 


Explanation The file cannot be accessed by the command you 
specified because the file is already open. This 
may mean it is in use by another program 
already in memory. 


Close the file and try again. 
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Filename too long 


Origin 
Explanation 


File not erased 
Origin 
Explanation 


File not found 
Origin 
Explanation 


File Sharing Conflict 
Origin 
Explanation 


Several commands 


DR DOS supports filenames up to eight 
characters with an optional filename extension 
up to three characters. This extension is 
separated from the filename by a period (.). 


Retype the command with a shorter filename. 


ERASE, ERA 


The file may be a password-protected file or a 
read-only file. 


Retype the command but add the correct 
password after the file specification. Or use the 
ATTRIB command to change a read-only file 
into a read-write file. 


Several commands 


The command cannot find the file specified in 
your command line. 


Check the spelling of the filespec. If the filespec 
was spelt correctly, use DIR or XDIR to check 
the contents of other directories for the location 
of the specified file. 


Any application 


This error only occurs on network systems. The 
action you have requested conflicts with the 
actions of another user. 


FORMAT not allowed on fixed media 


Origin 
Explanation 


BACKUP 


The command you have issued requires 
BACKUP to format a hard disk. This option is 
left out of BACKUP so that you cannot 
accidentally destroy the data on a hard disk. 


Backup onto diskettes instead. 
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Format unsuccessful 
Origin FORMAT 
Explanation The diskette may be corrupted. 


Try again. If the message recurs, your diskette 
is probably unusable. Consult your dealer. 


I/O error 


Origin Any application 


Explanation An Input/Output error occured while accessing 
the requested device. In the case of a 
diskette-drive, this may mean a corrupt diskette. 


IBMBIO.COM read error 


Origin Diskette system loader 


Explanation The programs used to startup DR DOS from 
diskette are corrupt or in the wrong order. 


Start DR DOS from a different startup diskette. 
If you want to use the failed startup diskette 
again you will need to reformat it using the /S 
(copy system files) switch within FORMAT. 


WARNING Reformatting a diskette destroys all the files originally 
stored on it. 


Illegal drive in Path Specification 


Origin Several commands 


Explanation You specified a drive that is not assigned in your 
system, or you mistyped the drive specification. 


Retype the command with a valid drive. 


Incompatible format for drive 


Origin DISKCOPY 


Explanation The diskette in the drive is not in the expected 
format for the drive. 
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Incorrect version of operating system 


Origin 


Explanation 


Origin 


Explanation 


Several commands 


The version numbers are different between the 

DR DOS running on your computer and the file 
containing the utility that you have just tried to 
load. 


The best solution is not to keep any old version 
of DR DOS on your disks. 


Input redirection already active 


Command line instructions 


You have tried to start input/output redirection 
when it is already happening. 


Insert SYSTEM diskette in A: then PRESS Ctrl/Alt/Del... 


Origin 
Explanation 


Insufficient memory 
Origin 
Explanation 

Invalid attempt to both 
Origin 
Explanation 


DR DOS hard disk system loader 


This message follows any error message that 
arises from the hard disk system loader. The 
effect is to get you to restart DR DOS from your 
startup diskette. 


SID 
There is not enough memory to load the file 
specified in an R or E command. 


SCC «ss. and remove 


PASSWORD 


You have attempted to set and reset an option at 
the same time. 
Refer to the PASSWORD command in Chapter 8 


for the permitted options and then retype the 
command. 
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Invalid baud rate 


Origin MODE 


Explanation The baud rate specified is not one of the 
standard baud rates. See the description of 
MODE in Chapter 8. 


Retype the command with a standard baud rate. 


Invalid break switch (use ON or OFF) 


Origin The config.sys file in the root directory of your 
startup disk. 


Explanation Use the SETUP program to set BREAK to ON 
or OFF, or directly modify the config.sys file, 
then restart the computer. Refer to the 
description of config.sys in Chapter 9 for 
details of the BREAK command. 


Invalid characters in label 


Origin LABEL 
Explanation: Create a different label, using only letters and 
numbers. 


Invalid character in password 


Origin PASSWORD 


Explanation: Create a different password, using only letters 
and numbers. 


Invalid code 


Origin GRAFTABL 


Explanation: Refer to the description of GRAFTABL in 
Chapter 8 for the correct code or use type the 
command followed by the /H(elp) option. 
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Invalid combination of options 


- Origin 
Explanation 


REPLACE, XCOPY 


Certain options conflict if they are selected 
together. 


Refer to the command explanations in Chapter 
8 for the available options. Type a new 
command that avoids the conflict. 


Invalid command in CONFIG.SYS file 


Origin 
Explanation 


Invalid country code 
Origin 


Explanation 


DR DOS startup procedure 


DR DOS does not recognize one of the 
commands in the config.sys file on the root 
directory of your startup disk. 


Remove the invalid command from config.sys; 
the valid commands are described in Chapter 9. 
There is no need to restart the computer. 


The config.sys file in the root directory of your 
startup disk. 


Alter the original config.sys file and then 
restart DR DOS. See the description of 
config.sys in Chapter 9 for a list of the 
supported country codes. 


Invalid data in font file filename.CPI 


Origin 


Explanation 


MODE PREPARE 


There is a conflict between the code page 
specified in the DEVICE statements and that 
specified in the MODE PREPARE command. 


Reload the font file from master disk. 
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Invalid date specified 
BntersGate:t.4 6 


Origin DATE, TOUCH 


Explanation Enter the date in the correct format for your 
country. See the entry for DATE in Chapter 8 
for examples of the correct format. 


Invalid destination path 


Origin REPLACE 


Explanation Retype the command with the correct path for 
the destination of the copied files. 


Invalid drive specified 


Origin Several commands 


Explanation You specified a drive that is not assigned in your 
system, or you mistyped the drive specification. 


Retype the command with the correct drive 
specification. 


Invalid file name 


Origin Several commands 
Explanation Retype the command with the correct filename. 


Invalid file specification 


Origin PRINT 
Explanation Retype the command with the correct path and 
filename. 


Invalid hard disk system partition 


Origin DR DOS hard disk system loader 
Explanation The system loader is unable to read information 
in the Partition Table. 


Restart DR DOS from diskette. Use the FDISK 
utility to recreate the partition on the hard disk. 


WARNING — Using FDISK will destroy all the data on that partition of 
your hard disk. 
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Invalid last drive character (use A...2Z) 


Origin 


Explanation 


Invalid lines per inch 
Origin 
Explanation 

Invalid line width 
Origin 
Explanation 


The config.sys file in the root directory of your 
startup disk. 


Use the SETUP program to amend the 
LASTDRIVE entry in config.sys or modify 
config.sys directly and restart DR DOS. Refer 
to the description of config.sys in Chapter 9 for 
details of the LASTDRIVE command. 


MODE 


You must specify either 6 or 8 lines per inch for 
your printer in the MODE command. 


MODE 


You must specify 80 or 132 characters per line 
for your printer in the MODE command. 


Invalid number of buffers 


Origin 


Explanation 


The config.sys file in the root directory of your 
startup disk. 


Amend the BUFFERS entry in config.sys 
using the SETUP program or modify config.sys 
directly, and then restart DR DOS. Refer to the 
description of config.sys in Chapter 9 for 
details of the BUFFERS command. 


Invalid number of data bits 


Origin 


Explanation 


MODE 


The databits setting specified is not one of the 
standard settings. See the description of MODE 
in Chapter 8. 


Invalid 


Invalid 


Invalid 


Invalid 


Invalid 
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number of files (use 5...255) 
Origin The config.sys file in the root directory of your 
startup disk. 


Explantion | Amend the FILES entry in config.sys using the 
SETUP program or modify config.sys directly, 
and then restart DR DOS. See Chapter 9 on 
config.sys for details of the FILES command. 


number of parameters 
Origin Several commands 
Explanation You have typed too many, or conflicting, options. 
Refer to the description of the command in 
Chapter 8. 
number of stop bits 
Origin MODE 
Explanation The stopbits setting specified is not one of the 
standard settings. See the description of MODE 
in Chapter 8. 
option - decimal number expected 
Origin SORT 
Explanation The /+n option of SORT stands for the on-screen 
column number at which you want the sort to 
occur. This number must be given as an 
ordinary number (a ‘decimal’), and not as a 
hexadecimal. 
Option .:. Im. paramever 
Origin ATTRIB, PASSWORD, REPLACE, XCOPY 
Explanation You have typed an option that DR DOS does not 
recognize. 


Refer to the command description in Chapter 8 
for the correct options and then retype the 
command. 
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Invalid parameter 
Origin 
Explanation 


Several commands 
You have typed an option that DR DOS does not 
recognize. 


Refer to the command description in Chapter 8 
for the correct options and then retype the 
command. 


Invalid parameter - missing option 


Origin 


Explanation 


Invalid parity setting 
Origin 
Explanation 


Invalid partition table 
Origin 
Explanation 


Invalid password 


Origin 
Explanation 


FIND 


You have typed an option that DR DOS does not 
recognize. 


Refer to the explanation of FIND in Chapter 8 
for the correct options and then retype the 
command. 


MODE 


The parity setting specified is not one of the 
standard parities. See the description of MODE 
in Chapter 8. 


DR DOS hard disk system loader 


More than one partition is marked as bootable 
(that is able to start DR DOS), a non-existent 
partition is marked as bootable, or there is a 
hard disk failure. 


Restart DR DOS from diskette. Use the FDISK 
utility to set the bootable partition, see 
Chapter 8. 


Several commands 


The password you have typed is not correct. 
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Invalid path or path not found 
Invalid path specified: check path 


Origin Several commands 
Explanation Retype the command with the correct path. 
Invalid SHELL filename 
Origin The config.sys file in the root directory of your 
startup disk. 


Explanation Amend the SHELL entry in config.sys and 
restart DR DOS. See also the description of 


config.sys in Chapter 9. 
Invalid switch .. (PRINT already installed) 
Origin PRINT 


Explanation The option you chose cannot be set because 
PRINT is already installed in memory. 


Carry on without the option, or restart DR DOS 
and load PRINT again. 


Invalid time specified 
Enter time: __ 
Origin TIME, TOUCH 
Explanation You entered the time in an incorrect format. 


Enter the time in the format as shown in the 
screen prompt. 


Label «.s not found 


Origin Batch file processing 


Explanation A GOTO statement in the batch file refers to a 
label that does not exist. 


Correct the batch file. 
Line too long in file 


Origin FIND 


Explanation You have tried to use FIND on a non-text file. 
FIND is only designed for text files. 
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Loading conflict 
Origin 


Explanation 


Log file path not found 
Origin 
Explanation 


Several commands 


There is probably not enough memory for the 
task you have specified. 


Free some memory by removing 
memory-resident programs that you do not need 
or, by reducing the amount of memory occupied 
by memory disks. 


BACKUP 


‘You have probably mistyped the path for the log 
file. 


Try again. 


Mono display adapter not found 


Origin 


Explanation 


No backup files present 
Origin 
Explanation 


No file 
Origin 
Explanation 
No files to backup 
Origin 


Explanation 


MODE 


The MONO display mode that you have 
specified is not supported by your display 
adapter. 


on source disk 


RESTORE 


You inserted a disk that contained no backup 
files, or you inserted a backup diskette out of 
sequence. 


SID 


The file specified in an R or E command could 
not be found on the disk. 


BACKUP 


No files matching the conditions you specified 
were found. You may have mistyped the file 
specification. 


No operating system 
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Origin Hard disk system loader 
Explanation This message originates in software that your 
supplier provides with the hard disk. 
Start DR DOS from the diskette. Copy DR DOS 
onto the hard disk and then use the FDISK 
utility to make the DR DOS partition “bootable” 
(that is, capable of loading DR DOS when the 
computer is started). 
No space 
Origin SID 
Explanation There is no space in the directory for the file 
being written by a W command. 
Non standard sector length - cannot write new boot sector 
Origin SYS 
Explanation You have typed Y when asked whether a new 


Not enough disk space 
Origin 
Explanation 


boot sector is to be written. However SYS 
cannot recognise the disk format, since the 
sector size is not 512 (or a multiple of 512 for a 
hard disk). 


Backup any data on the disk and reformat it 
under DR DOS. 


REPLACE, SORT, XCOPY 


The disk has too much stored on it. Erase some 
unwanted files from the disk and try again. 
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Not enough memory 
Not enough memory for 
Not enough memory to 


Origin Several commands 


Explanation There is insufficient free memory for the 
command to work. 


Free some memory by creating a smaller 
memory disk, or by removing memory-resident 
programs that you do not need. Then try the 
command again. 


Not ready error 


Origin Any application 


Explanation The device you are trying to access is not 
responding. In the case of a diskette-drive, this 
usually means there is no diskette in the drive, 
or the drive door is not shut. With hard disks, 
this error may mean a hardware failure. 


Check your diskette is inserted correctly into 
the diskette-drive, and the door is shut. For 
hard disks, contact your dealer. 


Operand 
Origin SID 


Explanation An attempt was made to assemble a command 
with an ambiguous operand. Precede the 
operand with the prefix “BYTE” or “WORD”. 


Operating system error 


Origin Several commands 


Explanation If you get this error message, make a note of the 
situation in which it occured, and contact your 
dealer. 
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Operating system load error 


Origin DR DOS hard disk system loader. 


Explanation The computer cannot read the operating 
system’s loader file. 


Restart DR DOS from diskette. Use BACKUP to 
save the files on the partition onto diskette. Use 
the FDISK utility to delete and then recreate 
the partition. Then use RESTORE to recover 
your files. 


Output redirection already active 


Origin Command line instructions 
Explanation You have tried to start input/output redirection 
with it already happening. 
Parameter not recognised 


Origin BACKUP, MODE, RESTORE 
Explanation You have typed an invalid option. 


Refer to the relevant command description in 
Chapter 8 for the permitted options. 


Parameters not compatible 


Origin FORMAT 
Explanation The options that you have typed contradict each 
other. 


Refer to the entry for the FORMAT command in 
Chapter 8, and then retype the command. 


Parameters not supported for drive 


Origin FORMAT 


Explanation The options you have typed are not supported 
on the diskette drive you specified. 


Path not found 
Origin PASSWORD, REPLACE, XCOPY 
Explanation The path you have typed is incorrect. 
Retype with the correct path. 


370 DRDOS User Guide 


Path is too long 
Origin 
Explanation 


FIND 


You have tried to specify a path name that is too 
long. 


Retype with the correct path. 


Path was too long to backup - skipping over 


Origin 
Explanation 


Physical Media Error 
Origin 
Explanation 


Print queue full 
Origin 
Explanation 


= 


Printer out of paper 


Origin 
Explanation 


BACKUP 
Your hierarchy of subdirectories is too complex. 


Simplify the arrangement of subdirectories on 
your disk and then try BACKUP again. 


Several commands 


DR DOS was unable to read from or write to a 
disk. The disk has probably been corrupted. 


Copy as many files as you can from the corrupt 
disk to another disk and then reformat or 
dispose of the first disk. 


PRINT 


If the printer is printing, try again later. 
Otherwise, delete a file that you do not need 
from the print queue and then try adding your 
file again. 


Any application 


The printer you are attempting to access is out 
of paper. 


Refill the paper tray, and try printing again. 


Program terminated normally 


Origin 
Explanation 


SID 


The program running under SID completed, or 
was terminated by a Ctrl+Break. 
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NN 


Protection level not changed file has no password 


Origin PASSWORD 


Explanation This message informs you that no password is 
attached to the file you have named in the 
command line. 


Read error on file 


Origin FIND 
Explanation Your disk may be corrupted. 
Try again with a backup copy. 


Resident portion installed 


Origin MODE 


Explanation A portion of the MODE.COM file remains in 
memory once MODE is invoked, slightly 
increasing the amount of space occupied by DR 
DOS on your system. This portion is called the 
resident portion. 


Sector not found 
Origin Any application 


Explanation The requested sector on the disk is not present, 
or is corrupt. With diskette-drives, this usually 
means that the diskette in the drive has not 
been formatted. 


Seek error 


Origin Any application 


Explanation The disk drive being accessed was physically 
unable to move its read/write heads to the 
requested location. This generally means a 
hardware failure. 


Contact your dealer. 
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Source and destination cannot be the same fil 


Origin COPY, REPLACE, XCOPY 


Explanation You have named the same file as both the 
source file and the destination file for the 
copying operation. 


Source and destination drives are the same 


Origin BACKUP, RESTORE 


Explanation The destination drive must be different from the 
source drive (the drive containing the disk to be 
backed up or restored). 


Retype the command with different source and 
destination drives. 


Source drive must be specified 


Origin BACKUP, RESTORE 


Explanation BACKUP and RESTORE need both the source 
drive (the drive containing the disk to be backed 
up or restored), and the destination drive to be 
included in the command you type. These drives 
must be different drives. 


Retype the command with the correct drives 


specified. 
Source file . . .. is not a valid source EXE file 
Origin EXE2BIN 
Explanation The file you tried to convert is not a valid 
executable type file. 


Source path not found 


Origin BACKUP, RESTORE 
Explanation You have probably mistyped the path. 
Try again. 
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Specified path is too long 


Origin Several commands . 


Explanation You'have tried to specify a path name that is too 
long. : 
Retype with the correct path. 


Specify source AND destination drives 


Origin BACKUP, RESTORE 


Explanation BACKUP and RESTORE need both the source 
drive (the drive containing the disk to be backed 
up or restored), and the destination drive to be 
included in the command you type. These drives 
must be different drives. 


Retype the command with the correct drives 
specified. 


Switch value out of range 


Origin PRINT 
Explanation The value chosen for the option is out of the 
allowed range. 


Refer to the description of PRINT in Chapter 8 
for the correct ranges for each option. 


SYS is not supported on this operating system 


Origin SYS 
Explanation SYS only runs under DR DOS. 


System files not found 


Origin FORMAT 

Explanation Specifies the /S switch within FORMAT but 
DR DOS cannot find the system files to copy 
onto the newly formatted disk. 
Retry the command with a copy of FORMAT 


that is on the disk from which you start 
DR DOS. 


374 DRDOS User Guide 
i i tah SASS a 


Time is not valid 


Origin 


Explanation 


BACKUP, RESTORE 
You have probably mistyped the time. 


Retype the command with a valid time. You may 
find the DR DOS TIME command helpful. 
Using it you can display, and if necessary, 
change the DR DOS current time. 


Too few parameters 
Origin MODE 
Explanation You have not typed in enough information. 
Refer to Chapter 8 for a description of the 
MODE command and its various formats and 
parameters. 
Too many files open 
Too many open files 
Origin Several commands 
Explanation You need to increase the number of files that 
can be open at one time. Read about the FILES 
command in Chapter 9. 
Too many files to sort 
Origin XDIR 
Explanation There is not enough room for XDIR to sort and 
then display all the files you have specified. 
Sort files from a subdirectory so that XDIR is 
sorting fewer files. 
Too many parameters 
Origin BACKUP, EXE2BIN, MEM, MODE, RESTORE 
Explanation You have specified too many, or conflicting, 


options. 


Refer to the description of the relevant 
command in Chapter 8. 
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Unable to backup due to sharing conflict 
Origin BACKUP 


Explanation The file you specified is currently being used by 
another process. 


Retry the command when the file is not being 


used. 
Unable to convert. Initial IP of . . . must be 0 or 100h 
Origin EXE2BIN 


Explanation For an .exe file to be converted to a .com file, 
its entry point must be at offset 100h within its 
segment. For an .exe file to be converted to a 
-bin file, its entry point must be at absolute 
offset 0 in its memory usage. If either of these 
cases is untrue, the conversion cannot be 


carried out. 
Unable to convert. Source file .. .hasa stack declared 
Origin EXE2BIN 


Explanation You cannot convert a .exe file to either a .com 
or .bin file if the program has a stack statement 


declared. 
Unable to convert. Source file ... requires relocation 
fixups 
Origin EXE2BIN 
Explanation The destination file is to be a .com type, but its 
header contains relocation items which must be 
performed. 
Unable to convert. Source file . . . requires too much 
memory 
Origin EXE2BIN 


Explanation The destination file is to be a com type but it 
requires more than 64 Kbytes to run. 
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Unable to create directory 


Origin MKDIR, XCOPY 


Explanation Your disk is probably full, or it is physically 
write-protected, or corrupt. You can also get this 
message if you try to create a directory with the 
same name as an existing directory. 


Use DIR to find out the amount of free space on 
the disk, and then delete unwanted files. Check 
the disk for write-protection (see Chapter 1, 
section 1.1). Try creating a different directory 
name, or create the directory on a different 


drive. 
Unable to delete existing volume label 
Origin LABEL 


Explanation The diskette is probably physically 
write-protected. 


Unable to find start of program code 


Origin EXE2BIN 


Explanation The source file contained a valid .exe header 
but no valid program code. 


Unable to open codepage font file 


Origin MODE PREPARE 


Explanation The code page font file specified in the MODE 
command could not be found. 


Make sure that you are specifying the drive, 
path and file name of the driver correctly. 


Unable to open or create destination file 


Origin EXE2BIN 


Explanation The program was unable to access the specified 
destination file. This is probably because there 
is already a read-only file of the same name. 
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Unable to open source file 


Origin EXE2BIN 


Explanation The specified source file does not exist. Check 
the name of your source file. 


Unable to perform refresh 


Origin MODE REFRESH 


Explanation The printer driver does not have a copy of the 
code page to download to the printer. 


Prepare and select the code page. To prevent 
this error recurring, make sure that the number 
of additional code pages (n) defined in the 
DEVICE=PRINTER.SYS statement is one or 
greater, see Chapter 9. 


Unable to read BACKUP file 


Origin RESTORE 


Explanation There is a problem with the diskette you have 
inserted. It may be the wrong diskette, or it may 
have been inserted out of sequence, or corrupted. 


Try again with the correct diskette. 
Unable to read from codepage font file 


Origin MODE PREPARE 


Explanation The complete contents of the font file could not 
be read because of a disk error that occurred 
during the MODE command. 


Reload the font file from the master disk. 
Unable to read relocation information 


Origin EXE2BIN 


Explanation The segment fixup information in the .exe 
header of the source file is not valid. 
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Unable to restore due to sharing conflict 


Origin RESTORE 


Explanation The file you specified is currently being used by 
another process. 


Retry the command when the file is not being 
used. 


Unable to set volume label 


Origin LABEL 


Explanation The diskette is probably physically 
write-protected. 


Remove the write-protection, (see Chapter 1, 
section 1.1), and try again. 


Unable to write to destination 


Origin RESTORE 


Explanation The destination disk is probably physically 
write-protected. Remove the write-protection, 
(see Chapter 1, section 1.1), and try again. 


Unable to write to destination file 


Origin EXE2BIN 


Explanation The program was able to open, but could not 
write to, the destination file. This is probably 
due to a hardware malfunction. 


Unknown error code 


Origin Several commands 


Explanation If you get this error message, make a note of the 
situation in which it occured, and contact your 
dealer. 


Unknown switch 


Origin Several commands 
Explanation You have specified an option that does not exist. 


Refer to the description of the command in 
Chapter 8 for a list of the valid options. Then 
retype the command. 
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Unrecognized display mode 


Origin MODE 


Explanation You have probably mistyped the display mode. 
The MODE command description in Chapter 8 
contains a listing of the display options. 


Unrecoverable read error on SOURCE diskette 
Unrecoverable read error on DESTINATION diskette 
Unrecoverable format error on DESTINATION diskette 
Unrecoverable verify error on DESTINATION diskette 


Origin DISKCOMP, DISKCOPY 
Explanation The diskette is probably corrupt. 
Use the backup copies of your files. 


Use another boot disk 


Origin Diskette system loader 


Explanation The programs used to startup DR DOS from 
diskette are corrupt, or in the wrong order. 


Startup DR DOS from a different startup 
diskette. If you want to use the failed startup 
diskette again you will need to reformat it using 
the FORMAT command with the /S (copy 
system files) switch. The FORMAT command is 
explained in Chapter 8. 


WARNING  Reformatting a diskette destroys all the files originally 
stored on it. 


Verify error 
Origin FORMAT 
Explanation You probably have a corrupt disk. 


Consult your dealer. 
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Verify error at s:o 


Origin SID 


Explanation The value placed in memory by a Fill, Set, 
Move, or Assemble command could not be read 
back correctly, indicating bad RAM or 
attempting to write to ROM, or non-existent 
memory at the indicated location. 


Write error 


Origin FORMAT 
Explanation You probably have a corrupt disk. 
Consult your dealer. 
Write protect error 
Origin Any application 


Explanation The diskette to which you are attempting to 
write is physically write-protected. 


Remove the write protection (see Chapter 1, 
section 1.1. if you are not sure about this), or 
use a different, non-write-protected diskette. 


Wrong boot sector format for SYS 


Origin SYS 


Explanation You may have typed N when asked whether a 
new boot sector is to be written. SYS only copies 
files to a disk with a DR DOS boot sector. 


Wrong version of operating system 


Origin BACKUP, MODE, RESTORE 


Explanation The version numbers are different between the 
DR DOS running on your computer and the file 
containing the utility that you have just tried to 
load. 


The best solution is not to keep any previous 
version of DR DOS on your disks. 
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A.2 Troubleshooting 


This section discusses several classes of errors, their causes, 
and some recovery procedures under the following headings: 


Q Troubleshooting checklist 
QO Diskette handling 
QO Corrupted files 


When absolutely nothing happens 


CO) 


 Unresolvable errors 


Troubleshooting checklist 


This checklist covers some of the more common error conditions. 


&) Have you prepared a DOS partition on your hard disk? You 
cannot access your hard disk until this is done. See 
Chapter 8 for a description of the disk partitioning utility, 
FDISK. 


Is your hard disk unit turned on? An external hard disk unit 
may have its own electrical connection. 


a 


4 Are the peripheral devices connected properly to your 
computer and to electrical outlets? 


g Ifa file is set to read-only, you cannot edit the file. Use the 
ATTRIB command to set the file to read-write, see 
Chapter 8. 

Q Did you specify a directory when typing the command line? 

By default DR DOS looks for the file only in the current 

directory of the current drive. 


Is the file password-protected? Refer to Chapters 4 and 8 for 
information on password protection. 


LU 


Are you running a program under the correct operating 
system version? Many DR DOS commands run only under 
the operating system with which they are shipped. 


a) 
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Diskette handling 


Diskette handling is the source of many errors. Here is a 
summary of points to check through (see also Chapter 1, section 
1.1 which describes how to handle diskettes.) 


Oo 
| 


ol 


Oo 


Is the disk correctly inserted and the drive door closed? 
Is the disk the correct type for the drive? 


Double-sided drives can read single-and double sided 
diskettes. Single-sided drives can access only single-sided 
diskettes. 


Some drives are designed to access both 1.2 Mbyte diskettes 
and 360 Kbyte diskettes. Other drives will only access one of 
these types. Still others will only access 160 Kbyte and 180 
Kbytes diskettes, or 3 14" diskettes. The FORMAT command 
description in Chapter 8 contains full details of diskette 
types. 


Is the disk physically write-protected? See Chapter 1, 
section 1.1 if you are unsure about write-protection. 


If the error is not caused by one of the above problems, the 
disk might be damaged. Use the COPY command (see 
Chapter 8) to copy information to a new disk. Replace any 
files you cannot copy with the files from your backup disk. If 
you have not maintained a backup disk, you must recreate 
the missing files. 


You can use the CHKDSK command to check the condition of 
your disks. The verification process is non-destructive. See 
Chapter 8 for instructions on how to use CHKDSK. 


If these directions fail to correct an error condition, you may be 
faced with a hardware error: contact your dealer. 
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Corrupted files 


Files can be corrupted by all kinds of unforeseen events. Power 
failures are probably the most common cause. 


Replace the damaged file from your backup copy. If you do not 
have a backup copy, you will have to recreate the file. 


If files are corrupted after you run a program that you yourself 
have written, debug the program carefully. Your program might 
be overwriting other files on the disk, or corrupting the 
directory. 


When absolutely nothing happens 


First, wait. Some programs take a long time to finish. Some 
errors, such as disk Input/Output errors, cause DR DOS to 
retry the operation many times. With experience, you will know 
when a command is taking too long. 


Unresolvable errors 


If you encounter an error condition you cannot correct, contact 
your dealer. Be prepared to provide the following information: 


cg) The text of any error messages you received. 


<) The serial number of your operating system. (This number 
appears on your distribution diskette label.) 


g) What your computer configuration is, that is the number of 
drives, quantity of memory, and any additional equipment 
such as printers or modems. 


<Q) Enough information to reproduce the error. Try to recall 
which programs were running when the error happened. If 
possible, provide a diskette with a copy of the program. 


Character sors for 
code pages 
supported by DR DOS 


This appendix shows the five code pages supported in DR DOS. 
To enter a character, hold down the Alt key while you type the 
decimal value shown in the table. 
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Decimal Value/ Coder nee Code rage Code ee Code Page Code Page 
Hex Value 437 860 865 850 


0/00h 
1/01h 
2/02h 
3/03h 
4/04h 
5/05h 
6/06h 
7/07h 
8/08h 
9/09h 
10/0Ah 
11/0Bh 
12/0Ch 
13/0Dh a 

14/0Eh 
15/0Fh 
16/10h 
17/11h 
18/12h 
19/13h 
20/14h 
21/15h 
22/16h 
23/17h 
24/18h 
25/19h 
26/1Ah 
27/1Bh 
28/1Ch 
29/1Dh 
30/1Eh 
31/1Fh 


@© 


+0; > Bi@iOle |> |* |* |< |@i@ 


=|") A Vieie/—l40 > @@iOie > |* |* |< |@l@ 
=/*/ A) Vixti=|>)+0 > @le@io- |> |+ |e |< |@lo 
=|7| A) Vitj|—/40| > @i@iDle |> |* |+ |e |@lO@ 


“TAY tye 
QD it Tt lL Jel] fe Fe f=] >] AL Vit] S)+0) > gle |> |» |+ |e 


QD it | Tt fy fe] fueed | feo bs 
Qt IT [tll leapt] feo fs 
QD ID | Lt fb [faye] | be fs 
QD it | Fit LL [ef leeet | foe fee |: 
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Decimal Value/ Code Page Code Page Code Page Code Page Code Page 
Hex Value 437 860 863 865 850 


32 /20h 

33 /21h ! ! ! ! ! 
34 /22h 7 " . ‘i 
35 /23h # # # # # 
36 /24h $ $ $ $ $ 
37 /25h % % %o Jo Jo 
38 /26h & & & & & 
39 /27h : : : : : 
40 /28h ( ( ( ( ( 
41 /29h ) ) ) ) ) 
43 /2Bh + + + + + 
44 /2Ch : ' ; , , 
45 /2Dh - - - - - 
46 /2Eh , : ‘ ; 
47 /2Fh , / / / / 
48 /30h 0 0 0 0 0 
49 /31h 1 1 if 1 1 
50 /32h 2 2 2 2 2 
51/33h 3 3 3 3 3 
52 /34h 4 4 4 4 4 
53 /35h 5 5 5 5 5 
54 /36h 6 6 6 6 6 
55 /37h 7 7 7 7 T 
56 /38h 8 8 8 8 8 
57 /39h 9 9 9 9 9 
58 /3Ah 

59 /3Bh : ; ; ; ; 
60 /3Ch < < a < < 
61/3Dh = = es = = 
62 /3Eh > > > > > 
63 /3Fh ? ? ? ? ? 
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Decimal Value/ Code page Code yee Code pase ods peaee Code age 
Hex Value 


64 /40h ce 3 r "6 r 
65 /41h A A A A A 
66 /42h B B B B B 
67 /43h CG C fe C C 
68 /44h. D D D D D 
69 /45h E E E E E 
70 /46h F F F F F 
71 /47h G el G G G 
72 /48h H H H H H 
73 /49h I I I I I 
74 /4Ah J J J J J 
75 /4Bh K K K K K 
76 /4Ch iy i L Ty L 
77 /4Dh M M M M M 
78 /4Eh N N N N N 
79 /4Fh O O O O O 
80 /50h P P P P P 
81 /51h Q Q Q Q Q 
82 /52h R R R R R 
83 /53h S S S S S 
84 /54h if , iT a. T 
85 /55h U U U U U 
86 /56h V V 4 V V 
87 /5Th Ww Ww W Ww Ww 
88 /58h x X x 4 x 
89 /59h Y Y Y x Y 
90 /BAh Z Z Z Z Z 
91/5Bh [ [ [ [ [ 

92 /5Ch \ \ \ \ \ 

93 /5Dh ] ] ] ] ] 

94 /5Eh A A A A A 


95 /5Fh 
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Decimal Value/ Code Page Code Page Code Page Code Page Code Page 
Hex Value 437 860 863 865 850 


96 /60h : : ‘ : , 

97 /61h a a a a a 
98 /62h b b b b b 
99 /63h c c c c c 
100 /64h d d d d d 
101 /65h e e e e e 
102 /66h £ if f f f 
103 /67h g g g g g 
104 /68h h h h h h 
105 /69h i i i i i 

106 /6Ah i i i i i 

107 /6Bh k k k k k 
108 /6Ch 1 1 1 1 1 

109 /6Dh m m m m m 
110 /6Eh n n n n n 
111 /6Fh 0) Co) Oo 0 Oo 
112 /70h P p p p Pp 
113 /71h q q q q q 
114/72h rc Tr r r r 
115 /73h Ss s s s s 
116 /74h t t t t t 

117 /75h u u u u u 
118 /76h v Vv Vv v v 
119 /77h w w w Ww w 
120 /78h x x x x x 
121/79h y y y y y 

122 /7Ah Z Z Z Z Zz 

123 /7Bh { { { { { 

124 /7Ch | | | | 

125 /7Dh } } } } } 

126 /7Eh ~ ~ ~ ~ = 
127 /7Fh a a eS a) 
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Decimal Value/ Code poe Oode ynee Code Bee Code ete Code moor 
Hex Value 437 863 865 850 
¢ ¢ 


128 /80h 
129 /81h 
130 /82h 
131 /83h 
132 /84h 
133 /85h 
134 /86h 
135 /87h 
136 /88h 
187 /89h 
138 /8Ah 
139 /8Bh 
140 /8Ch 
141 /8Dh 
142 /8Eh 
143 /8Fh 
144 /90h 
145 /91h 
146 /92h 
147 /93h 
148 /94h 
149 /95h 
150 /96h 
151/97h 
152 /98h 


@. | c: 
O |G: 


>> | s» 
9: | > 


@: |m fo [a | 9 


” |: |@> |e | Wo | My 


fog 


Coat 
Lt) 


> 


> 


153 /99h 
154 /9Ah 
155 /9Bh 
156 /9Ch 
157 /9Dh 
158 /9Eh 
159 /9Fh 


O|'9 Ct pe [CE] Orl ey |e Calor Jor Jo be | >? | Ge | Be | melee | Or} | ao tb] @ ko Pos] or | or fo fo fer OQ 
Me [DLO Jee fo [ETO fee | Jor Jo: fo [By | [te] Deft] He Jee fe: fo fo: [a fer for for fam: fa» |r Bt FO |B 


Sh [TD [wd ft be C3} O: |: |e | Jo Jo: > | Py 18 Heh | Poe] >] ee fem fe: [a |a: [a eo |e | a |: | om | ao BQ | 08 


OIC le pe [CEO] fee fe fee} tt} om | teh] te teh feos | | 
MH IX TQ le fo [ClO le | lo lo: o | py | 8 LEA] Doe] to: | wy 
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Decimal Value/ con. yaee Coe nee Code Page ec Be aee Hodes enoke 
Hex Value 860 863 850 


160 /AOh FA FA | FA FA 
161 /A1h i i ? i i 
162 /A2h 6 6 6 6 6 
163 /A3h tu tu a ti ti 
164 /A4h ai fi n nh 
166 /A6h . a 3 2 a 
167 /ATh 2 2 - 2 2 
168 /A8h é é i é é 
169 /A9h a O - = ® 
170 /AAh = z= = = = 
171/ABh % yy Ve ¥e Ww 
172 /ACh VY VY YW V4 Y4 
173 /ADh i i EZ i i 
174/AEh « « « « « 
175 /AFh » » » oO » 
176 /BOh 8 Hl # # EE 
177 /B1h ie Eg ie fa ie 
178 /B2h $5 $3 $8 i $3 
179 /B3h | | | | | 
180 /B4h a 4 4 - zi 
181 /B5h =| + + A 
182 /B6h -| = 4 + A 
183 /B7h A 4 7 4 A 
184 /B8h =a =a =| a © 
185 /B9h +| * 4 = +| 
186 /BAh | | | | | 
187 /BBh FT Fl ‘| =I =] 
188 /BCh - a _ _l _ 
189 /BDh ll _| | | ¢ 
190 /BEh _ a aif _| ¥ 
191/BFh =] 7 7 7 7 
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Decimal Value/ Coes Benge Code ee Code mee Code page Code gy 
Hex Value 860 850 


192 /COh L L 
193 /Clh ai 
194 /C2h TT 
195 /C3h + + 
196 /C4h = ~ 
197 /C5h + a 
198 /C6h = r 
199 /C7h + IF 
IL 

= 

ells 

=I 


200 /C8h a 
201 /C9h I 
202 /CAh 
203 /CBh 
204 /CCh 
205 /CDh 
206 /CEh 
207 /CFh 
208 /DOh 
209 /Dih 
210 /D2h 
211 /D3h 
212 /D4h 
213 /D5h 
214 /D6h 
215 /D7h 
216 /D8h 
217 /D9h 
218 /DAh 
219 /DBh 
220 /DCh 
221/DDh 
222 /DEh 
223 /DFh 


WIE] ale|alarH 


eb 


VIE) AH EYEE efile fate} pe 4] te rf 


B-|-ll a, ae pee eer tet | | tp | ty Jo | io [SE | Fe UE aa im ffm | | TIF Ir lg 


Bl 5 |b ie)4aP le} ASAE VEEL all 
A +e }a |r) eH El 
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Decimal Value/ wore ene Code nee Code Boe weds Baee Cour. en nee 
Hex Value 


224 /EOh 

225 /Eth 

226 /E2h 

227 /ESh 

228 /E4h 

229 /E5h 

230 /E6h 

231 /ETh 

232 /E8h 

233 /EQh 

234 /EAh 
235 /EBh 
236 /ECh 
237 /EDh 
238 /EEh 
239 /EFh 
240 /FOh 

241 /Fih 

242, /F2h 

243 /F3h 

244 /F4h 

245 /F5h 

246 /F6h : AS + + + 
247 /F7h - 
248 /F8h : : : ; 
249 /F9h ° ° ° ° 

250 /FAh : : : 

251 /FBh V V V V 1 
252 /FCh n a a a 3 
253 /FDh 
254 /FEh = = a = 
255 /FFh 


a 
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Memory 
management 


SING DR DOS you can make much more efficient use of available 
memory on your computer. 
This appendix defines the different types of memory and how 


you can optimize your own computer’s memory using various 
DR DOS commands. 
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C.] What is memory? 


Every computer must have memory to store programs and 
information, and to load and run programs. Memory used to 
hold programs and data while the computer is switched off, is 
called storage memory. The other type of memory that is used 
to load and run programs, is called Random Access Memory (or 
RAM for short). It can be thought of as the computer’s 
workspace. The more complex a task you want to do, the more 
RAM memory your computer needs. 


Information is stored in the computer as patterns of 1s and 0s, 
known as bits. A group of 8 bits is called a byte. Bytes are very 
important units of memory; characters such as "a", "3" or "?" 
can be represented in one byte of memory. One thousand and 
twenty-four bytes is equal to one Kilobyte (or Kbyte for short). 
Memory is also measured in Megabytes (Mbyte). One Megabyte 
is equal to 1024 Kilobytes. As modern computers contain a lot 
of memory, memory is usually talked about in terms of Kbytes 
and Mbytes rather than bytes. 


C.2 Types of memory 


There are several types of RAM memory in personal computers 
including: 


Conventional (or base) 


oo 


Upper memory 
Extended 


High memory area 


ooo 


oO 


Expanded 
They are explained in this section. 


DR DOS has several device drivers which provide special 
memory management features. These include EMM386.SYS for 
Intel i386 and i486-based computers with extended memory, 
and HIDOS.SYS for Intel 80286-based computers and for 
computers using Chips and Technologies LeAPSet, LeAPSetsx, 
NEAT, and NEATsx chip sets. For information on the types of 
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memory contained in your computer, consult your computer’s 
documentation, or your hardware dealer. 


Conventional memory 


Conventional memory (sometimes called base memory) is the 
first 640Kbytes of memory in the computer, see figure C.1. It is 
divided into two sections: 


QO The operating system area in the lowest part of base 
memory where your operating system and installable device 
drivers are commonly loaded. 


Q The area left over after your operating system is loaded, is 
where your own applications and data are loaded. 


Memory above the 640 Kbytes barrier is normally used for the 
video display adapter, and ROM BIOS in particular. 


Under DOS operating systems, applications can only run in the 
first 640 Kbytes of memory. This limitation is sometimes called 
the 640 Kbytes barrier. Other areas of memory can be used in a 
limited way, but only with certain types of hardware. Program 
designers usually prefer to write applications that can be run 
on a wide range of equipment. The more complicated the task 
to be accomplished, the larger the program will be. Your DR 
DOS operating system can be configured to take advantage of 
special memory areas in your computer, to ensure that your 
programs get as much conventional memory as possible with 
your hardware. 
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14 Mbyte 


For example 


Video Display Adaptor CGA, EGA, VGA 


640 Kbytes 


Y 


Conventional Memory 


U1, 


Operating System 


Figure C.1 8086 memory map 


For example 
DR DOS, or 
DOS-compatible system 


Upper memory 


Any memory addressed between 640 Kbytes and 1 Mbyte is 
known as upper memory, see figure C.2. Upper memory is 384 
Kbytes in size. Some sections of upper memory are reserved for 
use by various parts of your computer’s hardware, like the 
video display adaptor, and also the ROMBIOS. 


Your computer hardware may enable you to use one of the 
special DR DOS memory management drivers (EMM386.SYS 
and HIDOS.SYS). If so, you can take advantage of upper 
memory by loading installable device drivers, such as those 
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required to run a mouse or network card, into portions of upper 
memory that are not being used, by for example, the video 
adapter, hard disk controller, or other similar hardware. These 
device drivers would normally be loaded in conventional 
memory, but when they are loaded in upper memory, a larger 
amount of conventional memory is available to load your 
applications. It is also possible to relocate the main operating 
system kernel into upper memory. 


Extended memory 


Intel 8086-based computers are limited to a maximum of 

1 Mbyte of RAM. However Intel 80286, i386 and i486-based 
computers can address more than this, and the memory above 1 
Mbyte is referred to as extended memory, see figure C.2. 


Real and protected Normally Intel 80286, i386 and i486-based computers run in 

modes real mode which means they are simply running as fast 
8086-based computers. For a computer to access extended 
memory it has to be put into a special mode of operation called 
protected mode. 


Certain device drivers and programs have options which allow 
them to gain access to extended memory, for example: 


Q VDISK.SYS which has an option allowing you to set up a 
memory (or RAM) disk in extended memory, see Chapter 9. 


Q CACHE.EXE which has an option allowing you to set up a 
disk cache in extended memory, see Chapters 8 and 9. 
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High memory 


High memory is the first 64 Kbytes of extended memory, see 
figure C.2. It can usually only be used by one program, or one 
piece of computer code at a time and is only available on Intel 
80286, i386 and i486-based computers with more than 1 Mbyte 
of memory installed. It is sometimes referred to as the High 
Memory Area (or HMA). DR DOS can take advantage of high 
memory by moving the main operating system kernel into it, so 
increasing the amount of memory available for your 


applications. 
Yj Extended Memory Yj 
Ui 
1Mbyte } High Memory 
Upper Memory 
Video Display Adaptor 
640 Kbytes | 


Conventional Memory 


Operating System 
0 


Figure C.2 Memory map showing upper, high & 
extended memory 
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XMS (Extended Memory Specification) 


A protocol called XMS (Extended Memory Specification) 
developed by Lotus, Intel and Microsoft, provides a standard 
interface to upper, high and extended memory. Up to 15 Mbytes 
of extended memory can be accessed on 80286-based 
computers, and up to 1000 Mbytes of extended memory on Intel 
i386, and i486-based computers. 


Expanded memory 


Another way of combatting the 640 Kbyte conventional memory 
barrier is to use a type of memory called expanded or LIM 
memory. The LIM EMS standard was jointly devised by Lotus, 
Intel, and Microsoft. EMS is the Expanded Memory 
Specification. It describes ways in which a program may access 
up to 32 Mbytes of memory outside conventional memory. 
Programs that use expanded memory include spreadsheets, 
databases, and other programs that need access to large 
amounts of data. 


In the early days the only way to use EMS memory was to fit a 
special memory expansion card inside your computer. Now 
using virtual 8086 mode on Intel i386 and i486-based 
computers, these special memory cards can be emulated. 
Expanded memory is sometimes called paged memory because 
it is divided up into 16 Kbyte memory pages. 


Page frame These memory pages are accessed through a block of four 
16 Kbyte pages in upper memory, known as a page frame. 
Thus a 64 Kbyte area of upper memory is reserved for the page 
frame if access to expanded memory is required. 


EMM driver A device driver called the Expanded Memory Manager, or 
EMM, coordinates an application’s access to expanded memory. 
The EMM driver arranges things so that the physical pages in 
the page frame always give access to the correct logical pages in 
expanded memory. So when data is read from or written to a 
physical page in the page frame, EMM ensures that the data is 
read from or written to the associated page of memory on the 
expanded memory card. 


Expanded memory enables you to run programs which 
manipulate large amounts of data, and which would otherwise 
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not run efficiently in conventional memory. However, it requires 
that programs have been designed specifically to access it. 


DR DOS has two device drivers that can take advantage of 
expanded memory: EMMXMA.SYS and EMM386.SYS. 
EMM386.SYS is a special device driver which allows computers 
to emulate LIM expanded memory in extended memory. 


C.3 DR DOS memory-related commands 


There are several commands and device drivers within DR 
DOS which enable you to make use of memory above the 
640 Kbyte barrier on your computer. An overview is given of 
them in this section, but a full description can be found in 
Chapters 8 and 9. Note that before any of the following 
commands can be used, a device driver supporting upper 
memory must be loaded, for example EMM386.SYS or 
HIDOS.SYS; see Chapter 9. 


HILOAD 


The HILOAD command is used from the command line or in 
batch files to load applications into upper memory, so giving you 
more space for your other applications and data in conventional 
memory. 


Generally you would load TSR (Terminate-Stay-Resident) 
programs into upper memory. TSRs are programs which are not 
unloaded from memory when they finish execution, so they do 
not need to be loaded from disk each time they are executed. 


Not all applications can be loaded using HILOAD. It is most 
useful for loading network drivers, keyboard drivers and TSRs. 


HIINSTALL 


This command is identical to the HILOAD command except it 
is used to load applications into upper memory during startup. 
You can use the SETUP program to place the HIINSTALL 
command in your config.sys file. 


If there is not enough space in upper memory, you get a 
warning message indicating there was insufficient space, and 
the device driver is loaded into conventional memory. 


ee 
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HIDEVICE 


The HIDEVICE command is identical to the DEVICE command 
in that it enables device drivers to be installed, however it loads 
the device driver specified into upper memory. You can use the 
SETUP program to place the HIDEVICE command in your 
config.sys file. 


If there is not enough space in upper memory, you get a 
warning message indicating there was insufficient space, and 
the device driver is loaded into conventional memory. 


HIDOS 


DR DOS data structures are usually loaded into the lowest 
section of conventional memory. The HIDOS command loads as 
much as possible of DR DOS into upper memory, therefore 
increasing the amount of space you have for your own 
applications and data in conventional memory. You can use the 
SETUP program to configure the HIDOS command in your 
config.sys file. 


Checking on your computer’s memory usage 


To find out what memory you have on your computer, and how 
it is configured, use the MEM command. The MEM command 
gives a report on memory usage. It has various options you can 
use in any combination to produce different types of reports. It 
can be helpful if used in conjunction with the HILOAD, 
HIINSTALL, HIDEVICE and HIDOS commands, as you can 
use it to check for example, how much memory an application 
or device driver uses when successfully loaded into upper 
memory. 


The SID debugging 
kere) 


D.1 About SID 


Si is a powerful debugger. It allows you to test and debug programs 
interactively. 
Most users will not need to use SID, but a description is 
included in this guide for completeness. 
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Starting SID 


To start SID, type SID at the command prompt for example: 


C>SID 


You see the SID copyright message and prompt. SID is ready to 
accept your commands. You can now use the E command to load 
a program for a debugging session. SID tells you where in 
memory the program is loaded, for example: 


#eprogram.exe 


Start End 
1000:0000 1000:2000 


# 


Alternatively, you can type SID at the command prompt 
followed by the name of the program you want to debug, for 
example: 


C>SID program.exe 


Quitting SID 


To quit SID type Q or Ctrl+C at the # prompt. This returns 
control to the operating system. 


SID command conventions 


Acommand line in SID can be up to 64 characters in length, 
and must be terminated with a carriage return. SID does not 
process the command line until you press Enter. 


The first character, or in some cases the first two characters, of 
each command line determines the command action. The 
command character can be followed by one or more arguments. 
Arguments must be separated from each other by commas or 
spaces. No spaces are allowed between the command character 
and the first argument. 


Note that if the first character of a SID command line is a 
semicolon (;), the entire line is treated as a comment and 
ignored. 
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Specifying a 20-bit address 


Most SID commands require one or more addresses as 
operands. Because the 8086 processor can address up to 

1 Mbyte of memory, addresses must be 20-bit values. Enter a 
20-bit address as follows: 


SSSS:0000 


where ssss represents an optional 16-bit segment number and 
0000 is a 16-bit offset. SID combines these values to produce a 
20-bit effective address: 


ssss0 
+0000 


eecece 


The segment value, ssss, is optional. If you omit the segment 
value, a default value appropriate to the command being 
executed, is used. 


Hexadecimal numbers 


SID normally accepts and displays values in hexadecimal. The 
valid hexadecimal digits are the decimal digits 0 through 9 and 
the hexadecimal digits A, B, C, D, E, and F, corresponding to 
the decimal values 10 through 15. 


Decimal numbers 


To enter decimal numbers, precede the number with the # 
symbol. The number that follows must comprise one or more 
decimal digits (0 through 9). 


Character values 


SID accepts ASCII characters, enclosed in single quotation 
marks, as literal values in expressions. Characters remain as 
typed within the paired quotation marks that is, no case 
translation occurs. 


408 DRDOS User Guide 


Operators in expressions 


Numbers and strings can be combined into expressions using 
“+” and “-” operators. The entire sequence must be written 


without embedded blanks. 
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D.2 SID commands 


SID commands give you control of program execution and allow 
you to display and modify system memory and the CPU state. 
This section lists the SID commands in alphabetical order. The 
commands are summarized in Table D-1. 


Table D.1 Summary of SID commands 


Command Explanation 


? Displays available commands. 

2? Displays detailed command list. 

A Assembles 8086 mnemonics directly into 
memory. 

B Block compares memory and displays 
discrepancies found. 

D Displays memory in byte or word format. 

E Loads a file into memory so that the next G, T 
or U command can begin program execution. 

F Fills an area of memory with a byte or word 
constant. 

G Transfers control to the program being tested 
and optionally sets one or two breakpoints. 

H Provides hexadecimal arithmetic functions. 

Istring Sets up command line arguments. 

L Lists the contents of memory in assembly 
language. 

M Copies a block of data values from one area of 
memory to another. 

P Sets, clears and lists current breakpoints. 

Q Exits from the SID program. 

QI, QO Allows access to any of the 65,536 input/output 


ports. QI reads data from a port and QO writes 
data to a port. 


QR, QW Enables you to read and write data from 
absolute locations on a given disk drive. 
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Table D-1 continued 


Command Explanation 


R Reads a file into a contiguous block of memory. 

S Changes the contents of bytes or words of 
memory. 

SR Searches for a given ASCII “string” or pattern of 
bytes and lists the addresses where the pattern 
occurs. 

T Executes one or more instructions. 

U This is the same as T, but without register 
display. 

Vv Displays the values of the last file loaded using 
the E or R commands. 

W Writes the contents of a contiguous block of 
memory to disk file. 

x Examines or modifies the CPU registers and 
flags. 

Z Displays registers of an attached 8087 maths 
coprocessor. 
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? & 2? (Help) 


The ? command prints a list of available SID commands. The 
form is as follows: 


? 
The ?? command prints a detailed command list that, in 


addition to the SID commands, includes the available command 
options. The form is as follows: 


ae 
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A (ASSEMBLE) 


The A command assembles 8086 mnemonics directly into 
memory. It takes the form: 

As 

where s is the 20-bit address at which assembly starts. 

SID responds to the A command by displaying the address of 
the memory location where assembly begins. At this point, you 
enter assembly language statements. When you enter each 
statement, SID converts it to binary, places the value(s) in 
memory, and displays the address of the next available memory 
location. This process continues until you enter a blank line or 
a line containing only a period. SID responds to invalid 
statements by displaying a question mark, ?, and redisplaying 
the current assembly address. 


Note 

You can use an expression wherever a numeric value is valid in 
an assembly language statement. Under the A command, 
references to registers refer to the names of the registers, not to 
the contents of the registers as in other SID commands. Under 
the A command, there is no way to reference the contents of a 
register in an expression. 

Examples 


Assemble at 4000:218. 
#24000:213 

Set AX register to decimal 128. 
4000:0213 mov ax,#128 

Push AX register on stack. 
4000:0216 push ax 
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B (BLOCK COMPARE) 


The B command compares two blocks of memory and displays 
any discrepancies at the screen. The B command takes the form: 
Bs1,fl,s2 


where s1 is the 20-bit address of the start of the first block; fl is 
the offset of the final byte of the first block, and s2 is the 20-bit 
address of the start of the second block. 


If the segment is not specified in s2, the same value is used that 
was used for sl. 


Any differences in the two blocks are displayed on the screen in 
the form: 


ail bl a2 b2 


where al and the a2 are the addresses in the blocks; b1 and b2 
are the values at the indicated addresses. If no differences are 
displayed, the blocks are identical. 


Examples: 


Compare 200H bytes starting at 40:0 with the block starting at 
60:0. 


#b40:0,1f,60:0 
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D (DISPLAY) 


The D command displays the contents of memory as 8-bit or 
16-bit hexadecimal values, and in ASCII. The command takes 
the following forms, where s is the 20-bit address where the 
display starts, and fis the 16-bit offset within the segment 
specified in s where the display finishes. 


(a) D Displays memory from the current display 
address for 12 display lines. 

(b) Ds Response to (b) is similar to form (a) but the 
display address is first set to be the 20-bit 
address s. 

(c) Ds,f Displays the memory block between locations s 
and f. 

(d) DW 

(e) DWs 


(f) DWs,f Analogous to the first three forms, except that 
the contents of memory are displayed as 16-bit 
values, rather than 8-bit values, as shown below: 


SSSS:0000 WWWW WWWW . . . WWWW cccc ...cCc 


Memory is displayed on one or more display lines. Each display 
line shows the values of up to 16 memory locations. For the 
first three forms, the display line appears as follows: 


ssss:o0000 bb bb... bbcc...c 


Where ssss is the segment being displayed, and 0000 is the 
offset within segment ssss. The bb’s represent the contents of 
the memory locations in hexadecimal, and the c’s represent the 
contents of memory in ASCII. A period represents any 
non-graphic ASCII character. 

During a long display, you can abort the D command by typing 
Ctrl+Break at the console. 


Examples 


Display memory bytes from offset FOOH through F23H in the 
current data segment. 


#df00,f23 
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E (LOAD PROGRAM) 


The E command loads a file into memory so that the next G, T, 
or U command can begin program execution. The E command 
takes the forms: 


(a) E <filename> 
(b) E 


Form (a) loads the file by the name <filename>. The file is 
assumed to be either a .com or .exe file. If no file type is 
specified, .exe is assumed. To load a .com file, you must specify 
the file type with the filename. The contents of the CS, DS, ES, 
SS, SP, and IP registers are altered according to the type of file 
loaded. When the load is complete, SID displays the start and 
end address of the memory block where the file was loaded. Use 
the V command to redisplay this information later. 


Form (b) releases all memory being used by SID for programs. 


When loading a program file with the E command, SID releases 
any blocks of memory used by previous E or R commands, or by 
programs executed under SID. Only one file can be loaded for 
execution at a time. 


SID issues an error message if a file does not exist or cannot be 
successfully loaded in the available memory. 


Examples 


Load file test.exe: 


# etest 
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PCFILLD 


The F command fills an area of memory with a byte or word 
constant. The following are possible forms: 

(a) Fs,fb 

(b) FWs,f,w 

The s is a 20-bit starting address of the block to be filled, and f 
is a 16-bit offset of the final byte of the block within the 
segment specified in s. 

In response to form (a), SID stores the 8-bit value b in locations 
s through f. In form (b), the 16-bit value w is stored in locations 
s through fin standard form, low 8-bits first followed by high 8- 
bits. 

If s is greater than f or the value b is greater than 255, SID 
responds with a question mark. SID issues an error message if 
the value stored in memory cannot be read back successfully, 
indicating faulty or non-existent RAM at the location indicated. 


Examples 
Fill memory from 100H through 13FH with 0. 
#£100,13f,0 
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G (GO) 


The G command transfers control to the program being tested, 
and optionally sets one or two breakpoints. The following are 
possible forms: 


(a) G 

(b) G,b1 

(c) G,b1,b2 

(d) Gs 

(e) Gs,b1 

(f) Gs,b1,b2 

(g) -G (with forms a through f) 


where s is a 20-bit address where program execution is to start, 
and bi and b2 are 20-bit addresses of breakpoints. If no 
segment value is supplied for any of the addresses, the value 
defaults to the contents of the CS register. 


In forms (a), (b), and (c), no starting address is specified, so SID 
derives the 20-bit address from the CS and IP registers. Form 
(a) transfers control to your program without setting any 
breakpoints. Forms (b) and (c) set one and two breakpoints 
respectively before passing control to your program. Forms (d), 
(e), and (f) are analogous to (a), (b), and (c), except that the CS 
and IP registers are first set to s. The forms in (g) are 
analogous to forms (a) through (f), except that intermediate 
pass point displays are suppressed. 


Once control has been transferred to the program under test, it 
executes in real time until it encounters a breakpoint. SID then 
regains control, clears the breakpoints set by the G command, 
and indicates the address at which execution of the program 
under test was interrupted, as shown: 


*SSSS:0000 


The ssss corresponds to the CS, oooo corresponds to the IP 
where the break occurred. When a breakpoint returns control 
to SID, the instruction at the breakpoint address has not yet 
been executed. 


Examples 


Begin program execution at address given by CS and IP 
registers with no breakpoints set. 


#9 
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H (HEXADECIMAL MATH) 


The H command provides several useful arithmetic functions. 
The possible forms are as follows: 


(a) Ha,b 
(b) Ha 


Form (a) computes the sum (ssss), difference (dddd), product 
(pppppppp), and quotient (qqqq) with the remainder (rrrr) of 
two 16-bit values. The results are displayed in hexadecimal as 
below: 


+ ssss - dddd * pppppppp / qqqq (rrrr) 
Underflow and overflow are ignored in addition and subtraction. 


Form (b) displays the value of the expression a in hexadecimal, 
decimal, ASCII (if the value has a graphic ASCII equivalent), 
forms as shown: 


hhhh #ddddd ‘’c’ 
You can abort the display by pressing any key at the console. 


Examples 
Show sum, difference, product, and quotient of 5C28H and 80H. 


#h5¢28,80 
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| INPUT COMMAND TAIL) 


The I command prepares a file control block and command tail 
buffer in SID’s program segment prefix, and copies this 
information into the program segment prefix of the last file 
loaded with the E command. The command takes the following 
form: 


I<command tail> 


The <command tail> is a character string that usually contains 
one or more filenames. The first filename is parsed into the 
default file control block at 005CH. The optional second 
filename is parsed into the second part of the default file 
control block beginning at 0O6CH. The characters in <command 
tail> are also copied into the default command buffer at 0080H. 
The length of <command tail> is stored at 0080H, followed by 
the character string terminated with a binary zero. 


If a file has been loaded with the E command, SID copies the 
file control block and command buffer from the program 
segment prefix of SID to the program segment prefix of the 
program loaded. The location of the program segment prefix of 
a program loaded with the E command is the value displayed 
for DS on completion of the program load. 


Examples 


Set up a file control block at 5CH for the file filel.exe and put 
the string “filel.exe” in the buffer at 80H (in the program 
segment prefix of the last file loaded with an E command). 


# ifilel.exe 


Set up file control blocks at 5CH and 6CH for the files a:filel 
and b:file2, and copy the string following the i into the buffer 
at 80H. 


# ja:filel b:file2 c:file3 $px 
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L (LIST) 


The L command lists the contents of memory in assembly 
language. The following are possible forms: 

(a) L 

(b) Ls 

(c) Ls,f 

The s is a 20-bit address where the list starts, and fis a 16- bit 
offset within the segment specified in s where the list finishes. 


Each disassembled instruction is in the form: 
ssss:o0000 <prefixes> opcode <operands> 
<prefixes> are segment override, lock and repeat prefixes; 


opcode is the mnemonic for the instruction; the <operands> 
field contains 0, 1, or 2 operands, as required by the instruction. 


Form (a) lists twelve disassembled instructions from the 
current list address. Form (b) sets the list address to s and then 
lists twelve instructions. Form (c) lists disassembled code from 
s through f. 


The list address is always set to the next unlisted location in 
preparation for the next L command. When SID regains control 
from a program being tested (see G, T, and U commands), the 
list address is set to the current value of the CS and IP 
registers. 


You can abort long displays by typing Ctrl+Break during the 
list process or by entering Ctrl+S to halt the display 
temporarily. Ctrl+Q will restart the display. 


If the memory location being disassembled is not a valid 8086 
instruction, SID displays it in the form: 


??= nn 
The nn is the hexadecimal value of the contents of the memory 
location. 
Examples 
Disassemble instructions from 248CH through 244EH. 
H243c,244e 
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M (MOVE) 


The M command moves a block of data values from one area of 
memory to another. The M command takes the form: 

Ms,f,d 

The s is the 20-bit starting address of the block to be moved, fis 
the offset of the final byte to be moved within the segment 
described by s, and d is the 20-bit address of the first byte of the 
area to receive the data. If the segment is not specified in d, the 
same value is used as was used for s. 


Note 

If d is between s and f, part of the block being moved is 
overwritten before it is moved, because data is transferred 
starting from location s. 


Examples 
Move 10 bytes from 20:2400 to 30:100. 


#m20:2400,+9,30:100 
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P (PASS POINT) 


The P command sets, clears, and displays pass points. The 
following are the possible forms: 


(a) Pa,n 
(b) Pa 
(c) -Pa 
(d) -P 
(e) P 


A pass point is a permanent breakpoint that remains in effect 
until it is explicitly removed, as opposed to breakpoints set with 
the G command, which must be reentered with each G 
command. Pass points have associated pass counts ranging 
from 1 to OFFFFH. The pass count indicates how many times 
the instruction at the pass point executes before the control 
returns to the console. Up to sixteen pass points can be set ata 
time. 


An important distinction between breakpoints and pass points 
is that when execution stops at a breakpoint, the instruction at 
the breakpoint has not yet been executed. When execution 
stops at a pass point whose pass count has reached 1, the 
instruction at the pass point has been executed. This makes it 
simple to proceed from a pass point with a G command without 
immediately encountering the same pass point. 


Forms (a) and (b) are used to set pass points. Form (a) sets a 
pass point at address a with a pass count of n, where a is the 
20-bit address of the pass point, and n is the pass count, in the 
range 1 to OFFFFH. Ifa pass point is already active at a, the 
pass count is simply changed to n. SID responds with a 
question mark if there are already 16 active pass points. 


Form (b) sets a pass point at a with a pass count of 1. Ifa pass 
point is already active at a, the pass count is simply changed to 
1. SID responds with a question mark if there are already 16 
active pass points. Forms (c) and (d) are used to clear pass 
points. Form (c) clears the pass point at location a. SID 
responds with a question mark if there is no pass point set at a. 
Form (d) clears all the pass points. Form (e) displays all the 
active pass points in the form: 


nnonn SSSS:0000 


where nnnn is the current pass count for the pass point, 
ssss:0000 is the segment and offset of the pass point location. 
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When a pass point is encountered, SID displays the pass point 
information in the form: 


nnonn PASS ssss:oooo 


Next, SID displays the CPU state before the instruction at the 
pass point is executed. SID then executes the instruction at the 
pass point. If the pass count is greater than 1, SID decrements 
the pass count and transfers control back to the program under 
test. When the pass count reaches 1, SID displays the break 
address (that of the next instruction to be executed) in the 
following form: 


*SSSS:0000 


Once the pass count reaches 1, it remains at 1 until the pass 
point is cleared or the pass count is changed with another P 
command. 


Use pass points with the G, T, and U commands. When you use 
the G or U command, you can suppress the intermediate pass 
point display with the -G or -U forms (see the G and U 
commands). In this case, only the final pass points (when the 
pass count = 1) are displayed. You can interrupt the G or U 
command before its normal termination by pressing 
Ctrl+Break at the console. SID aborts the G or U command 
when the next pass point is encountered and prompts for the 
next command. You can also use pass points with breakpoints 
set with the G command. 


If a pass point and a breakpoint are set at the same address, 
the breakpoint is encountered first. Otherwise, pass points 
behave in the usual manner, decrementing the pass count until 
it reaches 1, and then returning control to SID. 


Normally, the segment registers are not displayed at pass 
points. You can use the S/-S command to enable/disable the 
segment register display (see the S command). 


Examples 

Display active pass points. 

# Pp 

Set pass point at address 1000:1234 
#p1000:1234 
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Q (QUIT) 


The Q command exits from SID. 
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QI, QO, QR, QW (QUERY I/O) 


The QI and QO commands allow access to any of the 65,536 
input/output ports. The QI command reads data from a port; 
the QO command writes data to a port. The QI command takes 
the following forms: 


QIn 
QIWn 


where n is the 16-bit port number. In the first case, SID 
displays the 8-bit value read from port n. In the second case, 
SID displays a 16-bit value from port n. 


The QO command takes the following forms: 
QOn,v 
QOWn,v 


where n is the 16-bit port number, and v is the value to output. 
In the first case, the 8-bit value v is written to port n. Ifv is 
greater than 255, SID responds with a question mark. In the 
second case, the 16-bit value v is written to port n. 


Examples 

Display the 16-bit value of input port 20H. 

# giw20 

Display the 8-bit value of input port 1024. 

# qi#1024 

Set the 16-bit output port number 20H to OF F7EH. 
# qow20,FF7E 

Set the 8-bit output port number 1025 to 2. 

# qo#1025,2 
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The QR and QW commands enable you to read and write data 
from absolute locations on a given disk drive. The two 
commands have identical parameters: 


QRs,drive,sector,count 
QWs, drive,sector,count 


where s is the segment:offset in memory into/from which data 
is to be read/written, drive is the drive number to use, for 
example 0=A:, 1=B:, sector is the starting sector number, and 
count is the number of sectors ito process. 


Examples 


To read 2 sectors from logical sector 15 of drive A: into memory 
starting at 9000:0000: 


QR9000:0,0,15,2 

To write the same two sectors back out to drive B: 
QW0,1,15,2 

Notice that the full segment part of the address need not be 
given if it has not changed since the last command. 


This command must be used with the upmost care, as vital 
information such as directories or file allocation tables can be 
damaged by incorrect use. 


Note 


A 32-bit sector number can be used which takes the form 
nnnn:nnnn, that is 0008:ffff for sector 3ffff. 
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R (READ) 


The R command reads a file into a contiguous block of memory. 
The R command takes the forms: 


(a) R<filename> 
(b) R<filename>,s 


where <filename> is the name and type of the file to be read, 
and s is the location to which the file is read. Form (a) lets SID 
determine the memory location into which the file is read. 
Form (b) causes SID to read the file into the memory segment 
beginning at s. This address can have the standard form 
(ssss:0000) as in the following example: 


#RCOMMAND.COM,1000:0 


The low-order four bits of s are assumed to be zero, so SID 
reads files on a paragraph boundary. 


SID reads the file into memory and displays the start and end 
addresses of the block of memory the file occupies. A V 
command can redisplay this information later. The default 
display pointer (for further D commands) is set to the start of 
the block occupied by the file. 


The R command does not free memory used by another R or E 
command. Thus, many files can be read into memory without 
overlapping. 


SID issues an error message if the file does not exist or there is 
not enough memory to load the file. 


Examples 


Read file sid.com into memory. 

#rsid.com 

Read file test into memory. 

#rtest 

Read file test into memory starting at location 1000:0. 
# rtest,1000:0 
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S (SET) 


The S command changes the contents of bytes or words of 
memory. The following are possible forms: 


(a) Ss 
(b) SWs 
(ec) S 
(d) -S 


where s is the 20-bit address where the change occurs. 


SID displays the memory address and its current contents on 
the following line. In response to form (a), the display is 


SSSS:0000 bb 
and in response to form (b), the display is 
SSSS:0000 WWWW 


where bb and wwww are the contents of memory in byte and 
word formats, respectively. 


In response to one of these displays, you can choose to alter the 
memory location or to leave it unchanged. If you enter a valid 
expression, the contents of the byte (or word) in memory is 
replaced with the value of the expression. If you do not enter a 
value, the contents of memory are unaffected and the contents 
of the next address are displayed. In either case, SID continues 
to display successive memory addresses and values until you 
enter a period on a line by itself, or until SID detects an invalid 
expression. 


In response to form (a), you can enter a string of ASCII 
characters, beginning with a quotation mark and ending with a 
carriage return. The characters between the quotation mark 
and the carriage return are placed in memory starting at the 
address displayed. No case conversion takes place. The next 
address displayed is the address following the character string. 
SID issues an error message if the value stored in memory 
cannot be read back successfully, indicating faulty or non- 
existent RAM at the location indicated. 


The forms (c) and (d) control the display of the segment 
registers when the CPU state is displayed with the trace 
command and at pass points. Form (c) turns on the segment 
register display, and form (d) turns it off. It is often convenient 
to turn off the segment register display while debugging to 
allow the CPU state display to fit on one line. 
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Examples 

Set byte to 0. 

1000:1234 55 0 

Set 3 bytes to’a’,’b’,’c’. 

1000:1235 55 "abc 

Set byte to decimal 75. 

1000:1238 55 #75 

Terminate the set command. 

1000:1239 55 . 

Enable segment register display in CPU state display. 
#s 

Disable segment register display in CPU state display. 
#-S 
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SR (SEARCH) 


The SR command searches a block of memory for a given 
pattern of numeric or ASCII values, and lists the addresses 
where the pattern occurs. The SR command takes the form: 


SRs,f,pattern 


where s is the 20-bit starting address of the block to be 
searched, fis the offset of the final address of the block, and 
pattern is a list of one or more hexadecimal values and/or 
ASCII strings. ASCII strings are enclosed in double or single 
quotation marks and can be any length. 


For each occurrence of pattern, SID displays the 20-bit address 
of the first byte of the pattern, in the form: 


SSSS:0000 


If no addresses are listed, the pattern was not found. 


Examples 


Search the memory block between 0:0 and 0:0FFFFH for the 3- 
character pattern that starts with “x”, ends with “y”, and has a 
decimal 27 in the middle. 


#5r0:0, fff, “x” #27 ,“y” 
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T. TRACE) 


The T command traces program execution for 1 to OFFFFH 
program steps, displaying the CPU state before each step. The 
T command takes the following forms: 


(a) T 

(b) Tn 
(c) TW 
(d) TWn 


The n is the number of program steps to execute before 
returning control to the console. If n is omitted, a single 
program step is executed. A program step is generally a single 
instruction, with the following exceptions: 


Q Ifa DR DOS interrupt instruction is traced, the entire 
function is treated as one program step, and executes in real 
time. This is because SID itself makes DR DOS calls, and 
DR DOS is not reentrant. 


4 The 8086 has a feature that disables interrupts (including 
the Trace Interrupt) for one instruction after a MOV or POP 
loads a segment register. For this reason, if the traced 
instruction is a MOV or POP whose destination is a segment 
register, the CPU executes the next instruction immediately. 
This prevents an interrupt occurring when the stack is 
undefined, for example between the two instructions in a 
sequence such as: 


MOV SS, STACKSEGMENT 
MOV SP, STACKOFFSET 


A sequence of such MOV or POP instructions plus one 
instruction after the sequence is considered a one program 
step. 


— If any of the TW forms are used and the traced instruction is 
a CALL, CALLF or INT, the entire called subroutine or 
interrupt handler (and any subroutines called therein) is 
treated as a one program step and executes in real time. 


Before each program step is executed, SID displays the CPU 
state, the disassembled instruction to be executed, and the 
contents of the memory location(s) referenced by the 
instruction, if appropriate. (See the X command for a detailed 
description of the CPU state display.) 
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The segment registers are not normally displayed with the T 
command, which allows the entire CPU state to be displayed on 
one line. To enable the segment register display, use the S 
command (see the S command). With the segment register 
display enabled, the display of the CPU state is identical to that 
of the X command. 


In all the forms, control transfers to the program under test at 
the address indicated by the CS and IP registers. If n is not 
specified, as in form (a), one program step is executed. 
Otherwise, SID executes n program steps and displays the CPU 
state before each step, as in form (b). You can abort a long trace 
before n steps have been executed by typing Ctrl+Break at the 
console. 


When n steps have been executed, SID displays the address of 
the next instruction to be executed in the form: 


*SSSS!:0000 


Forms (c) and (d) are analogous to forms (a) and (b), except in 
the way subroutine calls are treated. In the TW forms, the 
entire subroutine called from the program level being traced is 
treated as a single program step, and executes in real time. 
This allows tracing at a high level of the program, ignoring 
subroutines that have already been debugged, or for other 
reasons are not currently of interest. 


When a single instruction is being traced, interrupts are 
disabled for the duration of the instruction. This prevents SID 
from tracing through interrupt handlers when debugging on 
systems in which interrupts occur frequently. 


After a T command, the list address used in the L command is 
set to the address of the next instruction to be executed, and 
the default segment values are set to the CS and DS register 
values. 

Examples 

Trace one program step. 

#t 

Trace 65535 steps. 


#Hfftt 
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a 0 0€0—0— Oe 


U (UNTRACE) 


The U command is similar to the T command except that the 
CPU state is displayed only before the first instruction is 
executed, rather than before every step. The following are 
possible forms: 


(a)U 

(b) Un 

(c) UW 

(d) UWn 

(e) -U (with forms a through d) 

where n is the number of instructions to execute before 
returning control to the console. You can abort the U command 
before n steps have been executed by typing Ctrl+Break at the 
console. 


Form (e) differs from the analogous T command in that SID 
disables the display of intermediate pass points (while the pass 
count is greater than 1). In this case, only when the pass count 
reaches 1 is the pass information displayed (see the P 
command). 


Examples 
Trace without display 200H steps. 
#u200 


Trace without display 200H steps, suppressing the 
intermediate pass point display. 


#12200 
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V (VALUE) 


The V command displays the start and end addresses of the 
block of memory where the last file was loaded with the E or R 
commands. The V command takes the form: 


Vv 


SID responds to the V command with a question mark if 
neither the R nor E commands have been used. 
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W (WRITE) 


The W command writes the contents of a contiguous block of 
memory to disk. The following are the possible forms: 


(a) W<filename> 
(b) W<filename>,s,f 


where <filename> is the filename and file type of the disk file to 
receive the data, and s and f are the 20-bit first and last 
addresses of the block to be written. If the segment is not 
specified in f, SID uses the same value that was used for s. 


With form (a), SID assumes the s and f values from the last file 
read with an R command. If no file was read with an R 
command, SID responds with a question mark. This form is 
useful for writing out files after patches have been installed, 
assuming the overall length of the file is unchanged. 


With form (b), where s and f are specified as 20-bit addresses, 
the low four bits of s are assumed to be 0. Thus the block being 
written must always start on a paragraph boundary. 


If a file with the name specified in the W command already 
exists, SID deletes it before writing a new file. 
Examples 


Write to the file test.exe the contents of the memory block read 
into by the most recent R command. 


# wtest.exe 


Write the contents of the memory block 40:0 through 40:3F FF 
to the file test.exe on drive B:. 


# wb:test.exe,40:0,3fff 
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X (EXAMINE CPU STATE) 


The X command allows you to examine and alter the CPU state 
of the program under test. The X command takes the forms: 


(a) X 
(b) Xr 
(c) Xf 


where r is the name of a CPU register and f is the abbreviation 
of one CPU flag. Form (a) displays the CPU state in the format: 


AX BX CX ... SS ES MIP 
ween eens XXKX KXXKXXXKK . . . XKXK XXXX XXXK 
<instruction> <memory value> 


The nine hyphens at the beginning of the line indicate the state 
of the nine CPU flags. Each position can be either a hyphen, 
indicating that the corresponding flag is not set (0), or a 1- 
character abbreviation of the flag name, indicating that the flag 
is set (1). Table D-2 shows the abbreviations of the flag names. 


Table D-2 Flag name abbreviations 


Character Flag name 


Overflow 
Direction 
Interrupt Enable 
Trap 

Sign 

Zero 

Auxiliary Carry 
Parity 


Qw~rNnonwyArpb oO 


Carry 


The <instruction> is the disassembled instruction at the next 
location to be executed, which is indicated by the CS and IP 
registers. 


If an instruction references memory, the contents of the 
referenced location(s) are displayed in the <memory value> 
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field, preceded by an equal sign. Either a byte, word, or double 
word value is shown, depending on the instruction. In addition 
to displaying the machine state, the first form changes the 
values of the default segments back to the CS and DS register 
values, and the default offset for the L command to the IP 
register value. 


Form (b) allows you to alter the registers in the CPU state of 
the program being tested. The r following the X is the name of 
one 16-bit CPU register. SID responds by displaying the name 
of the register followed by its current value. If you type a 
carriage return, the value of the register is not changed. If you 
type a valid expression, the contents of the register are changed 
to the value of the expression. In either case, the next register 
is then displayed. This process continues until you enter a 
period or an invalid expression, or the last register is displayed. 


Form (c) allows you to alter a flag in the CPU state of the 
program being tested. SID responds by displaying the name of 
the flag followed by its current state. If you type a carriage 
return, the state of the flag is not changed. If you type a valid 
value, the state of the flag is changed to that value. Only one 
flag can be examined or altered with each Xf command. Set or 
reset flags by entering a value of 1 or 0. 


Examples 
Change registers starting with BP. 
#xbp 


Change BP to hex 2B64. 
BP=1000 2b64 


Change SI to decimal 12345. 
SI=2000 #12345 
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Z (Display the 8087 coprocessor registers) 


This command displays the registers of an attached 8087 maths 
coprocessor if one is present. 
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D.3 Default segment values 


SID has an internal mechanism that keeps track of the current 
segment value, making segment specification an optional part 
of a SID command. SID divides the command set into two types 
of command according to the segment a command defaults to if 
you do not specify a segment value in the command line. 


The first type of command, pertaining to the code segment, 
includes the A (Assemble), L (List), P (Pass Points) and W 
(Write) commands. These commands use the internal type-1 
segment value if no segment value is specified in the command. 
When invoked, SID sets the type-1 segment value to the first 
available free segment. 


O When an E command loads a file, SID sets the type-1 
segment value to the value of the CS register. 


O When an R command reads a file, SID sets the type-1 
segment value to the base segment where the file was read. 


OQ When an X command changes the value of the CS register, 
SID changes the type-1 segment value to the new value of 
the CS register. 


Ol 


When SID regains control from a user program after a G, T, 
or U command, it sets the type-1 segment value to the value 
of the CS register. 


When an Aor L command explicitly specifies a segment 
value, SID sets the type-1 segment value to the segment 
value specified. 


The second type of command, pertaining to the data segment, 
includes the B (Block Compare), D (Display), F (Fill), M (Move), 
S (Set), and SR (Search) commands. These commands use the 
internal type-2 segment value if no segment value is specified 
in the command. 
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When invoked, SID sets the type-2 segment value to the first 
available free segment. 


When an E command loads a file, SID sets the type-2 
segment value to the value of the DS register. 


When an R command reads a file, SID sets the type-2 
segment value to the base segment where the file was read. 


When an X command changes the value of the DS register, 
SID changes the type-2 segment value to the new value of 
the DS register. 


When SID regains control from a user program after a G, T, 
or U command, it sets the type-2 segment value to the value 
of the DS register. 


When a B, D, F, M, 8, or SR command explicitly specifies a 
segment value, SID sets the type-2 segment value to the 
segment value specified. 


When evaluating programs that have identical values in the 
CS and DS registers, all SID commands default to the same 
segment value unless explicitly overridden. 


Table D-3 summarizes SID’s default segment values. 


Note 


The G (Go) command does not fall into either group because it 
defaults to the CS register. 
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Table D-3 Summary of SID default segment values. 


Command type-1 type-2 
A aK 

B * 
D * 
E @ @ 
EF Bs 
G @ @ 
H 

I 

Is % 

M * 
P % 

QI 

QO 

R a @ 
g * 
SR * 
T @ @ 
U @ @ 
Vv 

W 3K 

x @ @ 


Key to Table D-3 


* Use this segment default if none specified; change default 
if specified explicitly. 


@ Change this segment default. 
% Use this segment default if none specified. 
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b.4 Assembly language syntax (A and L 
commands) 


In general, the syntax of the assembly language statements in 
the A and L commands is standard 8086 assembly language. 
Several minor exceptions appear here. 


Up to three prefixes (LOCK, repeat, segment override) can 


i 


CL) 


QO 


appear in one statement, but they all must precede the 
opcode of the statement. Alternatively, a prefix can be 
entered on a line by itself. 


The distinction between byte and word string instructions is 
made as follows: 


byte word 

LODSB LODSW 
STOSB STOSW 
SCASB SCASW 
MOVSB MOVSW 
CMPSB CMPSW 


The mnemonics for near and far control transfer 
instructions are as follows: 


short normal far 
JMPS JMP JMPF 
CALL CALLF 

RET RETF 


If the operand of a CALLF or JMPF instruction is a 20-bit 
absolute address, it is entered in the form: 


SSSS:0000 
where ssss is the segment and 0000 is the offset of the 
address. 


Operands that can refer to either a byte or word are 
ambiguous and must be preceded either by the prefix 
“BYTE” or “WORD”. These prefixes can be abbreviated to 
“BY” and “WO”. For example: 


INC BYTE [BP] 
NOT WORD [1234] 
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Failure to supply a prefix when needed results in an error 
message. ; 


QO Operands that address memory directly are enclosed in 
square brackets to distinguish them from immediate values. 


For example: 
ADD AX,5; add 5 to register AX 
ADD AX,[5]; add the contents of location 5 to AX 


“1 The following are the forms of register indirect memory 
operands: 


[pointer register] 
[index register] 
[pointer register + index register] 


The pointer registers are BX and BP, and the index registers 
are SI and DI. Any of these forms can be preceded by a 
numeric offset. For example: 


ADD BX, [BP+SI] 
ADD BX, 3[BP+SI] 
ADD BX, 1D47[BP+S]I] 


Glossary 


Ambiguous filename 


A filename that contains either of the DR DOS wildcard 
characters ? or *. When you replace characters in a filename 
with these wildcard characters, you create an ambiguous 
filename and can easily reference more than one DR DOS file 
in a single command. 


Application 


A piece of software used to carry out a particular task, like a 
word processor or graphics package. 


ASCIl 


The American Standard Code for Information Interchange is a 
standard code for representing numbers, letters and symbols. 
An ASCII text file is a file that can be intelligibly displayed on 
the video screen or printed on paper. 


Autoexec.bat file 


This is a configuration file which DR DOS executes everytime it 
is started. The easiest way to change the autoexec.bat file is 
to use the SETUP program. 


Backup 


A copy of a file, directory or disk made for safe keeping. 
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Batch file 


A file containing a sequence of commands. When you type the 
name of the file at the command line, each command in the file 
is carried out in turn, just as if you had typed the commands 
individually. The filename becomes in effect a “command” in 
itself. Batch filenames can be up to eight characters in length, 
but must always have the extension .bat. 


Baud rate 


The baud rate is the number of bits transmitted per second in 
serial communications. 


Bit 


A bit is the smallest unit of memory in a computer. Bits are 
electronic switches. They are given values to indicate whether 
they are switched on or off, 0 is off and 1 is on. Eight bits are 
equal to one byte, or character. See also Byte. 


Buffer 


An area of memory that temporarily stores data during 
information transfer. 


Built-in command 
See Internal command. 
Byte 


Aunit of memory or disk storage usually used to represent one 
character. See also Bit. 
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Cache 


Acache or disk cache is an area of RAM memory used to store 
data accessed frequently from disk. If your applications want to 
access a disk for data, it can become time-consuming. To speed 
up the process of reading and writing data to and from disk, 
you can set up a cache. Whenever data is read or written from 
disk, a check is made to see if a copy is in the cache first. If it is 
in the cache, the copy is used. Caches are very useful for 
increasing the performance of applications that have to access a 
lot of data from disk, like databases and spreadsheets. 


Code page 


A code page is a table stored in your computer which defines 
the particular character set required by a specific national 
language. 


Code page switching 


This is amechanism DR DOS uses to allow you to use the 
range of characters needed in a variety of national languages. 
Using it you can switch between the different character sets 
needed by differing languages. 


Command 


Ashort program in DR DOS designed for a specific task. 


Command line 


The command followed by any other relevant information given 
at one time to the computer, to enable it to carry out your 
instructions. The command line ends when you press the Enter 
key. 


Communications port 


A socket to which another computer may be attached usually 
via a cable, thus allowing the computers to communicate with 
each other. 
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Config.sys file 


A configuration file which DR DOS executes everytime it is 
started. It contains various commands used to set up your 
system for items like keyboard and country information. The 
easiest way to change the config.sys file is to use the SETUP 
program. 


Conventional memory 


Memory below 640 Kbytes, sometimes called base memory. It is 
generally where the operating system and applications are 
loaded. It is usually referred to as RAM (Random Access 
Memory). See also Appendix C. 


Current disk drive 
The drive on which DR DOS first looks for files. The current 
drive letter is the one displayed on the DR DOS prompt. 


Cursor 


A blinking line or block on the screen that indicates where your 
next keystroke will have an effect. 


Databits 


Refers to the number of bits used to define a character on serial 
data transmission, usually 7 or 8. When connecting two 
computers together via the communication ports, it is 
important to set the same number at each end. 


Default 


A pre-set value used by a computer until it is specifically 
changed by a user. 


Device 


A device is a piece of hardware attached to a computer (usually 
a peripheral), for example a printer or mouse. 
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Device driver 


Device drivers are programs that are loaded alongside the 
operating system to operate hardware devices which are not 
recognized as a default part of the system. Device drivers 
usually have the extension .sys. 

Directory 


A place on disk where filenames are stored so that DR DOS can 
find the files when needed. Each disk can contain many 
directories. 


Disk 


Magnetic medium used for storing information. 


Disk cache 
See Cache. 


Diskette 
A disk that can be removed from the drive (also known as 
floppy disks). 

Disk operating system 
A collection of programs that manages computer resources and 
other programs on a computer. 

Drive 
The device that holds and reads a hard disk or diskette. 


EDITOR 


ADR DOS program that allows you to create and edit ASCII 
text files on a computer. 


EMM 
Expanded Memory Manager, see also Appendix C. 
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EMS 
Expanded Memory Specification, see also Appendix C. 


Enter key 


The key that tells DR DOS to carry out a command. Also 
referred to as Return or -. 


Executable 


This means “programs that can be run by the computer”. 
Executable code is a series of instructions that can be carried 
out by the computer. Executable programs usually have the 
extension .exe or .com. 


Expanded memory 


Expanded memory is often known as LIM memory. The LIM 
EMS standard was jointly devised by Lotus, Intel and 
Microsoft®. EMS is the Expanded Memory Specification. It 
describes ways in which a program may access up to 32 Mbytes 
of memory outside conventional memory. Programs that use 
expanded memory include spreadsheets, databases, and other 
programs that need access to large amounts of data. For more 
details see Appendix C. 


Extended memory 


Memory above 1 Mbyte on 80286, i386 and i486-based 
computers, see also Appendix C. 


External command 


Commands that are used less often than other commands, and. 
so are not automatically loaded into memory. To save space 
they are stored on disk instead. They have the file extension 
.com or .exe. When you enter an external command, DR DOS 
retrieves the “command file” from disk and runs it. The 
memory used by the command is freed when it has finished its 
work. See also Internal command. 


Glossary 451 


File 


A collection of related instructions or data stored on disk. 


File Allocation Table (FAT) 


The File Allocation Table is a kind of index which exists at the 
start of every disk, and is used by the operating system to 
locate entries for files. 


Filename and filename extension 


The name assigned to a file. A filename can include a primary 
filename of 1 through 8 characters and optional filename 
extension of 1 through 3 characters. A period (.) separates the 
filename from the filename extension. 


Filespec 
Short for file specification. The combination of drive letter, 
path, and filename that identifies a file uniquely to DR DOS. 
Fixed disk 
See Hard disk. 


Floppy disk 


See Diskette. 


Format 


The process by which DR DOS prepares a disk for use by 
writing electronic markers onto the disk, so that DR DOS can 
store and retrieve files. FDISK is used to format hard disks and 
the FORMAT command is used to format diskettes. When you 
format a disk, all the information previously stored on the disk 
is erased, so take care when you use these commands. 


Hard disk 


A disk for storing information that is not removable from the 
computer. They usually have large storage capacity and provide 
fast access to data. 
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High memory 
The first 64 Kbytes of extended memory, see also Appendix C. 


Input 
Information going into the computer, usually from you typing at 
the keyboard or from a program reading from disk. 

/O 


Abbreviation for input/output. 


Internal command 
ADR DOS command that usually resides in memory. These 
commands respond quickly because they are do not have to be 
loaded from disk. 

Kilobyte (Kbyte or KB) 
1024 bytes, denoted as 1Kbyte, 1 KB or 1 K. 32 Kilobytes equal 
32 Kbytes. 1024 Kbytes equal 1 Megabyte (or Mbyte), over one 
million bytes. 

Label 
Amarker within a batch file. It is used to indicate the specific 
point that execution jumps to, following a GOTO statement. 


LIM 
See Expanded memory. 


Logical drive 


The operating system’s internal representation of a drive. It 
may refer to an actual disk device, or to a group of directories 
specified using the SUBST command. 


Megabyte (Mbyte or MB) 


A unit of storage in a computer denoting 1024 Kbytes. It is 
usually denoted as 1 Mbyte or 1 MB. 
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Memory 


Memory is where the computer stores data and programs. It is 
measured in bytes. One byte is equal to a group of eight bits. A 
bit is the smallest unit of memory in a computer. Each bit has 
the value 0 or 1. Memory is thought of in bytes because one 
byte of memory can be used to represent a character such as 
"g" "2" or "4", One thousand and twenty-four bytes is equal to 
one Kilobyte or (Kb) for short. As computers contain a lot of 
memory, memory is usually talked about in terms of Kilobytes 
rather than bytes. The usual size of memory in personal 
computers is 640Kbytes, or greater. See also Appendix C. 


Memory disk 


A portion of computer memory that is made to act like a very 
fast disk. You store your files on it in the same way as ona 
physical disk. Information stored on a memory disk is lost when 
the computer is switched off or when DR DOS is restarted. 
Memory disks are therefore best used for temporary storage of 
expendable data. They are also referred to as RAM disks or 
Virtual disks. 


Modem 


Modulator/Demodulator. A device which converts a digital 
signal from a computer into an analogue signal which can then 
be transmitted down telephone lines and decoded by a modem 
at the receiving end. 


Online 


A computer or peripheral is “online” when it is switched on and 
ready to accept information. 


Operating system 
See Disk operating system. 


Output 


Data that the computer sends to the console, disk or some other 
device. 
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Parallel 


The carrying out of several tasks at the same time. For example 
in parallel communications, 8 bits of a byte would be 
transmitted together (see also Seria/). 

Parity 
A means of checking that data has been transferred correctly, 
either between computers across a communications link, or 
between components inside a single computer, such as a disk 
and memory. 

Partition 
A partition is a section of a hard disk created by the FDISK 
disk preparation utility. 

Password 
Aseries of characters needed to gain access to a computer, file 
or directory. 


Path 


The description of the route through the directory hierarchy to 
a subdirectory or file. A drive letter can also be included at the 
beginning of the path. 

PC 


An abbreviation for personal computer 


Peripheral 


An external device connected to the computer. Peripherals are 
generally used for input and output. Examples include disks, 
modems, and printers. 


Piping 
The process where the output from one program is made to be 
the input for another. 
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Program 


Aseries of specially coded instructions that perform a specific 
task when executed by a computer. 


Prompt 


The display on the screen that shows you DR DOS is ready to 
receive a command. The standard DR DOS prompt can be 
changed by using the PROMPT command. 


RAM 


Random Access Memory is a type of memory that is used to 
load and run programs from. It can be thought of as the 
computer’s workspace. The more complex a task you want to 
do, the more RAM memory your computer needs. It is memory 
that can be read to, as well as written from, in any order. See 
also ROM. 


RAMdisk 
See Memory disk. 


Read-only (RO) 


An attribute that can be assigned to a file or directory. When 
switched on, the read-only attribute allows you to read from the 
file but not to write any changes to it. 


Real time 


Asystem where execution depends on critical timing criteria. 
For example a system may be required to respond to some 
event within a given time. 


RETURN 
See Enter key. 
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ROM 


Read-Only Memory. This is a type of memory which you can 
only read or copy; you cannot alter it’s contents. It is normally 
used to contain the computers diagnostic programs, and a very 
basic input/output system (or BIOS). 


Root directory 


The main directory that DR DOS creates on disk when the disk 
is formatted. 


Scrolling 


Scrolling means to move text up or down on a screen so that 
you can read it all. 


Serial 


The carrying out of tasks one after the other. For example in 
serial communications, each byte is transferred one bit at a 
time (see also Parallel). 


Session 


Asession at your computer is the time between switching on 
and when you next switch off. 


SID debugging tool 


A powerful debugger which allows you to test and debug 
programs interactively, see Appendix D. 


Stopbits 


A term used in serial data transfer to distinguish where one 
character starts and another stops, communication programs 
normally add one, or sometimes two, stopbits on the end of each 
character. Like databits, it is important that the number of 
stopbits set up agrees at both ends of the line. 


Strings 


A sequence of characters, such as "hello" or "arc132", 
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Subdirectory 


Any directory that is not the root directory on a disk can be 
called a subdirectory. 


Timeout 


DR DOS sets a time limit for response to a command, so it can 
detect if something is taking too long to respond (for example a 
printer may have inadvertently been switched off), and return 
an error message. 


Upper memory 


Memory between 640 Kbytes and 1 Mbyte (384 Kbytes) 
reserved for use by the video display adapter, add-on adaptors, 
and system software, see also Appendix C. 


Utility 


ADR DOS program that enables you to perform certain 
operations such as copying, erasing, or editing files. 


Variable 


In batch files, a variable is a character that is substituted for a 
filename when the batch file is run. 


Video memory 


Aspecial area of memory used by the hardware which operates 
the computer’s display or monitor. 


Virtual disk 
See Memory disk. 
Volume label 


The name given to a disk for identification. It is set by the 
LABEL command. You can display the volume label on a disk 
using the VOL command. 
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Wildcard characters 


Special characters that match certain specified items. In DR 
DOS there are two wildcard characters, ? and *. The ? can be 
substituted for any single character in a filename and the * can 
be substituted for one or more characters in the filename or 
filename extension, or both. 


Wildspec 


The same as filespec except that you can use wildcard 
characters in the command syntax to specify groups of files. 


Write-protected 


A write-protected disk, directory or file can be read but not 
altered or erased. Disks are write-protected physically, usually 
by the absence or presence of a notch on the diskette casing. 
Files are write-protected via the ATTRIB command (setting the 
read-only attribute), and files and directories can be 
write-protected via the PASSWORD command. 


XMS 


Extended Memory Specification which defines a protocol that 
controls access to high, upper, and extended memory on Intel 
80286, 1386, and i486-based personal computers. 


Index 


conditional execution of config.sys 
commands, 282 
(SID command), 411 
wildcard, 32 
2? (SID command), 411 
@ 
batch subcommand, 91 
syntax for filelist, 107 
% in batch file processing, 87 
%% variable 
FOR command, 95 
* wildcard, 32 
.bak files, 73 
.bat files, 83 
.com files, 24, 165 
.cpi files, 332 
.exe files, 24, 165 
/H help switch, 25, 113 
3 Winch diskettes, 4 
5 4 inch diskettes, 4 
< redirection symbol, 80 
> redirection symbol, 78 
| piping symbol, 81 


A 


accented characters, 200 
additional 
device drivers, 303 
address 
specifying a 20-bit in SID, 407 


aligning 
display on a CGA monitor, 211 
Alt key 
definition of, xiv 
ambiguous filename 
definition of, 445 
ANSLSYS, 305 
escape sequences, 305 
escapes sequences for changing display 
modes, 307 
escape sequences for erasing, 307 
escape sequences for positioning the 
cursor, 306 
extended character codes, 309 
format of options for, 305 
naming in config.sys, 305 
restrictions on, 305 
screen mode values, 308 
screen modes, 307 
APPEND command, 119-121 
appending output, 80 
applications 
definition of, 445 
enabling them to use expanded memory, 320 
loading into upper memory, 197 
starting from autoexec.bat, 330 
using other, 21 
archive attribute, 59, 124 
ASCII 
definition of, 445 
ASSEMBLE (SID command), 412 
assembly language syntax, 442 
ASSIGN command, 122-123 
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assigning 

drive letters, 300 

passwords, 56, 228 

printers (MODE), 214 
assumptions 

in the manual, xiii 
ATTRIB command, 59, 124-125 
attributes 

archive, 59 

hidden, 59 

read-only, 59 

system, 59 
autoexec.bat file, 328 

definition of, 445 

example of with code page switching, 336 

and SETUP, 278 

Starting applications from, 330 
automatic backup files 

EDITOR, 73 


B 


backing up 
definition of, 445 
directories, 52 
filenames containing wildcard characters, 53 
hard disks, 50 
modified files, 52 
backup 
disks, checking contents of, 53 
files, EDITOR, 73 
log, 127 
BACKUP command, 50, 126-128 
error codes, 127 
base memory 
see conventional memory 
batch file processing, 83 
batch files 
creating, 85 
definition of, 26, 446 
environment variables, 88 
general purpose, 86 
running, 85 


stopping, 86 

variables, 87 
batch subcommands, main entries, 

@, 91 

‘LABEL, 92 

CALL, 93 

definition of, 26 

ECHO, 94 

FOR, 95 

GOTO, 96 

IF, 97 

PAUSE, 100 

REM, 101 

SHIFT, 102 

summary table, 89 
baud rates 

definition of, 446 

FILELINK command, 181 

MODE command, 217 
BDOS 

relocating, 317 
binary files 

converting .exe files to, 165 
bit 

definition of, 446 
BLOCK COMPARE (SID command), 413 
blocks of text 

working with in EDITOR, 71 
bootable partitions 

selecting, 176 
BREAK 

config.sys command, 283 

DR DOS command, 129 
breakpoints, 422 
buffers 

definition of, 446 
BUFFERS command, 284 
built-in command 

see internal command 
byte 

definition of, 446 
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C 


cable 
needed for FILELINK, 188 
cache 
definition of, 447 
setting up at the command line, 130 
setting up in config.sys, 310 
CACHE command, 130-131 
CALL batch subcommand, 93 
CD command, 43, 133-135 
CGA adapter 
displaying extra characters on, 195 
CGA monitor 
aligning display (MODE), 211 
CHAIN command, 285 
changing 
code pages, 132, 338-339 
command prompt, 48, 236 
configuration defaults, 277 
date, 152 
directories, 43, 133 
filenames, 46, 241 
time, 258 
characters 
not allowed in disk labels, 203 
not allowed in filenames, 31 
sets for code pages, 385 
values in SID, 407 
CHCP command, 132, 338 
CHDIR/CD command,43, 133-135 
special characters, 133 
checking 
contents of backup disks, 53 
data is correctly written to disk, 267 
disks, 136 
checklist 
troubleshooting, 381 
Chips & Technologies chipsets 
accessing upper memory, 321 
CHKDSK command, 136-139 
clearing 
passpoints, 422 
screen display, 140 


CLS command, 140 
code page 850, 333 
limitations of, 334 
code page switching, 331 
character sets in, 385 
definition of, 332, 447 
Code Page Information files, 332 
enabling on VGA and EGA displays, 312 
example config.sys and autoexec.bat, 336 
hardware supported, 335 
MODE options, 220-225 
setting up, 219, 335 
support for printing, 324 
code pages 
changing, 132, 338-339 
definition of, 447 
displaying selected, 223 
listing current, 339 
preparing, 220 
refreshing, 225, 340 
selecting, 222 
setting up, 219, 335 
columns 
setting display number of, 212 
combining 
files, 147 
pipes and redirection, 82 
COMMAND, 141-142 
definition of, 447 
command line 
definition of, 23, 447 
editing, 109, 111 
getting started at, 15 
command processor 
loading different (SHELL), 302 
command prompt 
changing, 48, 236 
command summary 
batch, 89 
config.sys, 2, 81 
DR DOS, 113 
EDITOR, 75 
SID, 409 
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command switches 
definition of, 27 
command syntax, 106 
definition of, 27 
COMMAND.COM, 141-142 
commands 
see also DR DOS commands 
and autoexec.bat, 328 
conventions in batch processing, 90 
conventions in config.sys, 280 
conventions in DR DOS commands, 106 
conventions in SID, 406 
EDITOR, 75 
external, 24 
entering, 16 
internal, 24 
learning about, 23 
piping together, 81 
specification, 27 © 
stopping, 28 
types of, 24 
communications port 
definition of, 447 
setting up , 217 
COMP command, 143 
comparing 
blocks of memory (SID), 413 
diskettes, 158 
files, 143 
COMSPEC, 249 
concatenating files 
COPY command, 147 
conditional execution 
of config.sys commands, 282 
of DR DOS commands, 97 
config.sys 
command conventions, 280 
command summary, 281 
definition of, 448 
example of with code page switching, 336 
and SETUP, 278-279 
config.sys commands, main entries, 
?, 282 
BREAK, 283 


BUFFERS, 284 

CHAIN, 285 

COUNTRY:.SYS, 286 

definition of, 26 

DEVICE, 288 

DRIVPARM, 290 

ECHO, 291 

FASTOPEN, 292 

FCBS, 293 

FILES, 294 

HIDEVICE, 295 

HIDOS, 296 

HIINSTALL, 297 

HISTORY, 298 

INSTALL, 299 

LASTDRIVE, 300 

REM, 301 

SHELL, 302 

summary table, 281 
configuration files 

autoexec.bat, 328 

config.sys, 278-279 

transferring control to, 285 
configuring 

your system, SETUP, 277 
connecting 

drives using JOIN, 198 
console 

copying files to, 148 
control keys, 112 
conventional memory 

definition of, 2, 397, 448 

increasing size of on MDA, Hercules 

& CGAs, 317, 322 
conventions 

see also commands 

in the manual, xiii 
converting 

.exe files to binary files, 165 
COPY command, 45, 144-149 

device names and descriptions, 148 
copying 

blocks of text (EDITOR), 72 

directories, 269 
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diskettes, 54, 160 
files, 45, 144 
files to a console or printer, 148 
files using REPLACE, 243 
files using XCOPY, 269 
master diskettes, 20 
multiple files, 269 
COUNTRY.SYS command, 286-287 
country codes, selecting, 286 
CPU state 
examining, 436 
creating 
batch files, 85 
directories, 42, 207 
disk labels, 203 
DOS extended partitions, 174 
DOS partitions, 172 
DOS primary partitions, 173 
files in EDITOR, 62 
files with COPY, 149 
general purpose batch files, 86 
logical drives in an extended partition, 174 
substituted drives, 255 
system disks, 257 
Ctrl key 
definition of, xiv 
CTTY command, 150 
currency format 
providing, 286 
current 
directory, 36 
directory, changing to, 133 
disk drive, definition of, 448 
hard disk status, 171 
path, displaying, 134 
cursor 
definition of, 448 
moving in EDITOR, 65 
CURSOR command, 151 
cursor-control diamond 
EDITOR, 67 
customizing 
your system, 277 


D 


data 
protecting, 49 
databits 
definition of, 448 
date 
format, setting (country.sys), 286 
resetting file date stamp, 260 
setting, 152 
DATE command, 152-153 
dead keys, 200 
DEBUG 
see SID 
debugging tool, 405 
decimal numbers (SID), 407 
default 
definition of, 448 
default segment values (SID), 439 
DEL command, 154 
delaying batch file processing, 100 
deleting 
blocks of text (EDITOR), 72 
characters (EDITOR), 69 
directories, 44, 248 
directories with XDEL, 272 
disk labels, 203 
DOS partitions, 175 
files with DEL, 45, 154 
files with DELQ, 155 
files with ERAQ, 163 
files with ERASE, 164 
lines (EDITOR), 70 
multiple files, 272 
non-DOS partitions, 175 
words (EDITOR), 70 
DELQ command, 155 
device 
definition of, 448 
redirecting I/O to using CTTY, 150 
redirecting output to, 78 
DEVICE command, 288 
device drivers 
ANSLSYS, 305 
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CACHE.EXE, 310 
definition of, 449 
DISPLAY.SYS, 312 
DRIVER.SYS, 313 
EMM386.SYS, 315 
EMMXMA.SYS, 320 
Expanded Memory Manager, 401 
HIDOS.SYS, 321 
installable, 303 
loading high, 321 
PRINTER.SYS, 324 
VDISK.SYS, 326 
summary of, 281 
device names 
reserved, 31 
use with redirection, 79 
devices 
specify with CTTY, 150 
DIR command, 17, 156-157 
directories 
and APPEND command, 119 
backing up, 52, 126 
copying with XCOPY, 269 
creating, 42, 207 
current, 36 
definition of, 34, 449 
deleting with XDEL, 272 
displaying and changing (CHDIR), 43, 133 
displaying contents of with XDIR, 274 
displaying tree structure of, 41, 262 
listing, 17,41, 156 
naming, 35 
parent, 36 
and PATH command, 39, 231 
and paths, 38 
protecting, 57 
removing, 44, 248 
root, 34 
DIRECTORY 
FILELINK command, 186 
dirname 
defined, 106 
disk operating system 
configuration size, 12 


configuring, 277 
definition of, 8, 449 
installing, 11 
transferring (SYS), 257 
DISKCOMP command, 158-159 
DISKCOPY command, 160-162 
diskettes 
see also disks 
checking contents of, 53 
checking what is on backup, 53 
comparing, 158 
copying, 54, 160 
copying masters, 20 
definition of, 3, 449 
deleting label on, 203 
displaying contents of, 156 
displaying label on, 268 
displaying tree structure of, 262 
formatting, 191 
handling, 5, 382 
modifying label on, 203 
problems with, 382 
types of, 3-4 
types supported by DISKCOPY, 160 
write-protecting, 6 
disks 
see also diskettes, memory disks 
backing up, 50, 126 
buffers, 284 
cacheing, 130, 310 
checking condition of, 136 
checking what is on backup, 53 
configurations of, 9 
creating labels on, 203 
definition of, 3, 449 
deleting label on, 203 
displaying directory of, 156 
displaying tree structure of, 262 
displaying volume label of, 268 
modifying label on, 203 
operating system, 8 
partitioning, 170 
preparation of, 10 
recovering, 238 
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status reports, 136, 171 
types of, 3 
DISPLAY (SID command), 414 
DISPLAY 8087 COPROCESSOR REGIS- 
TERS (SID command), 438 
DISPLAY.SYS, 312 
displaying 
8087 coprocessor registers, 438 
contents of directories (DIR), 17, 43, 133, 
156 
contents of memory (SID), 414 
current path, 134 
the date, 152 
contents of directories (XDIR), 274 
DR DOS version number, 266 
file contents, 46, 265 
information on memory, 205 
logical drives in an extended partition, 177 
messages during startup, 291 
passpoints, 422 
path of directories (TREE), 41, 262 
remarks during batch file execution, 101 
selected code page, 223 
text a screenful at a time, 28, 226 
text file on screen, 265 
the time, 258 
displays 
aligning, 211 
setting type of, 210 
DOS 
extended partitions, creating, 174 
partitions, creating, 172 
partitions, deleting, 175 
primary partitions, creating, 173 
DR DOS configuration files, 278 
control key combinations, 112 
default command processor, 141 
definition of, 8 
displaying version number, 266 
error messages, 342 
installable device drivers, 303 
installing, 11 
new features, vi 
system files, transferring, 257 
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APPEND, 119 
ASSIGN, 122 
ATTRIB, 124 
BACKUP, 126 
BREAK, 129 
CACHE, 130 
CHCP, 132 
CHDIR/CD, 133 
CHKDSK, 136 
CLS, 140 
COMMAND, 141 
COMP, 143 
COPY, 144 
CTTY, 150 
CURSOR, 151 
DATE, 152 

DEL, 154 
DELQ, 155 

DIR, 156 
DISKCOMP, 158 
DISKCOPY, 160 
EDITOR, 61 
ERAQ, 163 
ERASE/ERA 164 
EXE2BIN, 165 
EXIT, 168 
FASTOPEN, 169 
FDISK, 170 
FILELINK, 178 
FIND, 189 
FORMAT, 191 
GRAEFTABL, 195 
GRAPHICS, 196 
HILOAD, 197 
JOIN, 198 
KEYB, 200 
LABEL, 203 
MEM, 205 
MKDIR/MD, 207 
MODE, 209 
MORE, 226 
NLSFUNC, 227 
PASSWORD, 228 
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PATH, 231 duplicating 
PRINT, 233 tree structures on other disks 
PROMPT, 236 (XCOPY), 270 


RECOVER, 238 
RENAME/REN, 241 


REPLACE, 243 E 
RESTORE, 245 
RMDIR/RD, 248 ECHO 
SET, 249 batch subcommand, 94 
SETUP, 13, 278 config.sys command, 291 
SHARE, 251 editing 
SID, 405 command line, 109 
SORT, 253 text files, 61 
SUBST, 255 EDITOR 
SYS,.257 backup files, 73 
TIME, 258 command summary, 75 
TOUCH, 260 copying blocks of text, 72 
TREE, 262 definition of, 449 
TYPE, 265 deleting blocks of text, 72 
VER, 266 deleting characters, 69 
VERIFY, 267 deleting lines, 70 
VOL, 268 deleting text, 68 
XCOPY, 269 deleting words, 70 
XDEL, 272 entering text in, 63 
XDIR, 274 inserting files at the cursor, 68 
summary table, 113 inserting text, 68 
drive letters marking blocks of text, 71 
assigning, 300 moving blocks of text, 71 
DRIVER.SYS, 313 moving text down a line, 64 
drivers moving the cursor, 65 
see device drivers online help in, 65 
drives overwriting text, 68 
connecting to empty subdirectory, 198 quitting, 63 
definition of, 8, 449 saving files, 72 
displaying volume label, 268 Starting, 62 
letters, assigning, 300 storing blocks of text in a file, 72 
specifying, 28 technical details, 74 
substituting, 255 EGA display 
types supported by DISKCOPY, 160 enabling code page switching on, 312 
types supported by FORMAT, 191 EMM386.SYS, 315 
DRIVPARM command, 290 and the VCPI interface, 318 
DUPLICATE EMMXMA.SYS, 320 


FILELINK command, 182 
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enabling 
applications to use expanded memory, 320 
code page switching on EGA and VGA, 312 
Enter key 
definition of, xiv, 450 
environment variables 
in batch files, 88 
and SET command, 249 
ERA command, 164 
ERAQ command, 163 
ERASE command, 164 
erasing 
see deleting 
error codes 
BACKUP, 127 
RESTORE, 246 
error messages, 342 
errors 
unresolvable, 383 
escape sequences 
ANSLSYS, 305 
EXAMINE CPU STATE (SID command), 436 
EXE2BIN command, 165-167 
executable 
definition of, 450 
EXIT command, 168 
expanded memory 
definition of, 401, 450 
page frame, 401 
support for, 315, 320 
Expanded Memory Manager, 401 
extended 
character codes (ECCs), 309 
command line editing, 111, 298 
memory, definition of, 399, 450 
partitions, creating, 174 
partitions, creating logical drive, 174 
Extended Memory Specification 
definition of, 401, 458 
extensions 
filename, 30 
external commands 
definition of, 24, 450 
help screens, 25 


F 


FASTOPEN command, 169 
in config.sys, 292 
FAT 
see File Allocation Table 
FCBS command, 293 
FDISK command, 170-177 
Main Menu, 171 
starting, 171 
file 
attributes, 59, 124 
File Allocation Table (FAT) 
definition of, 451 
File Control Blocks (FCBS), 293 
file specification, 38, 106 
FILELINK 
baud rates, 180 
cable, 188 
FILELINK commands, 178-188 
DIRECTORY, 186 
DUPLICATE, 182 
QUIT, 187 
RECEIVE, 185 
SETUP, 180 
SLAVE, 182 
TRANSMIT, 183 
filenames 
definition of, 31, 451 
extensions not to be used, 30 
names not to be used, 31 
files 
see also batch files 
see also configuration files 
attributes, 59 
autoexec.bat, 328 
backing up, 50, 126 
Code Page Information, 332 
combining, 147 
comparing, 143 
config.sys, 278-279 
contents, displaying, 46, 265 
converting .exe to .com, 165 
copying, 45, 144 
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copying with REPLACE, 243 
copying with XCOPY, 269 
corrupted, 383 
COUNTRY.SYS, 286 
creating with COPY, 149 
creating with EDITOR, 62 
definition of, 30, 451 
deleting with DEL, 45, 154 
deleting with DELQ, 155 
deleting with ERAQ, 163 
deleting with ERASE, 164 
deleting with XDEL, 272 
displaying contents of, 46, 265 
filelist support, 107 
finding string of characters in, 189 
listing, 107, 156, 262, 274 
locking, 251 
naming, 31 
number open (FILES), 294 
printing, 47, 233 
protecting with passwords, 55, 228 
recovering, 238 
renaming, 46, 241 
replacing, 243 
resetting time and date stamps, 260 
restoring backup, 53, 245 
sharing, 251 
wildcard characters, 32 
FILES command, 294 
filespec 
definition of, 106, 451 
FILL (SID command), 416 
filter commands, 81, 189, 226, 253 
FIND command, 189-190 
fixed disks 
see hard disks 
flags 
SID, 436 
floppy disks 
see diskettes 
FOR batch subcommand, 95 
FORMAT command, 191-194 
drive types supported, 191 


formatting 
definition of, 451 
diskettes, 191 
hard disks, 170 


G 


general purpose batch files, 86 
global 
passwords, 57, 229 
wildcard, 33 
GO (SID command), 417 
GOTO batch subcommand, 96 
GRAFTABL command, 195 
GRAPHICS command, 196 


H 


handling 

diskettes, 5, 382 

files with wildcards, 32 
hard disks 

backing up, 50 

current status of, 171 

definition of, 3, 451 

formatting, 170 

maintenance utility, 170 

partitioning, 170 

selecting alternate, 177 
hardware 

code page, 332 

cursor, 151 

supported by code page switching, 335 
help 

online in EDITOR, 65 

online during installation, 11 

online in SETUP, 278 

online in SID, 411 

switch, 25, 113 
HEXADECIMAL MATH (SID command), 418 
hexadecimal numbers 

in SID, 407 
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hidden attribute, 59, 124 
HIDEVICE command, 295 
HIDOS command, 296 
HIDOS.SYS, 321 
high memory 
definition of, 400, 452 
loading kernel into, 321 
HIINSTALL command, 297 
HILOAD command, 197 
HISTORY command, 298 


VO 
definition of, 452 
IF batch subcommand, 97 
input 
definition of, 452 
redirecting, 80 
INPUT COMMAND TAIL 
(SID command), 419 
inserting 
files at the cursor (EDITOR), 68 
remarks in a batch file, 301 
strings into command processor’s 
environment, 249 
text (EDITOR), 68 
INSTALL command, 299 
INSTALL program 
starting, 11 
installable device drivers, 303 
see also device drivers 
summary of, 303 
installing 
DR DOS, 11 
FILELINK, 182 
programs at startup, 299 
interactive 
batch processing, 83 
internal commands 
definition of, 24, 452 
international 
currency format, setting, 286 


date and time formats, setting, 286 
issuing 
passwords, 56 


J 


JOIN command, 198-199 


K 


kernel 

loading high, 315, 321 
KEYB command, 200-202 
keyboard typematic rate 

setting, 212 
keys 

command line editing, 110 

Ctrl and Alt, xiv 

Enter, xiv 

extended command line editing, 111 
kilobytes 

definition of, 452 


L 


LABEL 

batch subcommand, 92 

definition of, 452 

displaying volume, 268 

DR DOS command, 203-204 
laptops 

getting a visible cursor, 151 
LASTDRIVE command, 300 
layout 

of commands example, 117 
LeaPSet chip sets 

accessing upper memory, 321 
learning 

about commands, 23 
levels 

of password protection, 55 
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LIM memory 
definition of, 401, 450 
support for, 315, 320 
lines 
setting display number of, 212 
LIST (SID command), 420 
assembly language syntax, 442 
listing 
current code page, 339 
directories, 17, 41, 156, 262 
files, 17, 41, 156, 262 
LOAD PROGRAM (SID command), 415 
loading 
second COMMAND.COM, 141 
device drivers into upper memory, 295 
different command processors, 302 
DR DOS operating system data in upper 
kernel high, 315, 321 
memory, 296 
programs into upper memory, 197, 297, 321 
programs with INSTALL, 299 
log file 
BACKUP command, 127 
logical drives 
associating a physical drive with, 290, 313 
creating in an extended partition, 174 
definition of, 452 
displaying in extended partition, 177 
lost clusters, 136 


M 


Main Menu 
FDISK, 171 
making 
batch files, 85 
directories, 42, 207 
general purpose batch files, 86 
text files, 62 
manual 
assumptions and conventions, xiii 
structure of, ii 


marking text blocks 
EDITOR, 71 
master diskettes 
copying, 20 
MD command, 42, 207-208 
megabytes 
definition of, 452 
MEM command, 205-206 
memory 
management, 395 
comparing blocks of (SID), 413 
conventional, 397 
definition of, 2, 396, 453 
displaying information on, 205 
expanded, 401 
extended, 399 
filling an area with byte or word 
constant, 416 
high, 400 
listing contents of in assembly language, 420 
moving blocks of data values in, 421 
paged, 401 
related commands, 402 
types of, 2, 396 
upper, 398 
memory disks 
definition of, 7, 453 
setting up (VDISK.SYS), 326 
messages 
error, 342 
MKDIR/MD command, 42, 207-208 
mnemonics 
8086, assembling into memory, 412 
mode 
insert and overwrite in EDITOR, 68 
protected, 399 
real, 399 
screen (ANSI.SYS), 307 
virtual 8086, 401 
MODE command, 209 
aligning the display on a CGA monitor, 211 
assigning printers, 214 
code page switching options, 219-225 
displaying selected code page, 223 
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preparing code pages, 220 
refreshing active code page, 225 
selecting.a code page, 222 
setting up communication ports, 217-218 
setting display type, 210 
setting keyboard typematic rate, 212 
setting lines and columns, 212 
setting up printers, 215-216 
modems 
definition of, 453 
modifying 
command prompt, 48, 236 
disk labels, 203 
MORE command, 81, 226 
MOVE (SID command), 421 
moving 
files between directories, 242 
blocks of text (EDITOR), 71 
within SETUP, 14 
text down a line (EDITOR), 64 
multi-level directory structure, 34 


N 


naming 

directories, 35 

files, 31 
national prepared code pages, 333 
NEAT chipsets 

accessing upper memory, 321 
networks 

sharing and locking files (SHARE), 251 
new features 

of DR DOS, vi 
NLSFUNC command, 227, 338 
non-DOS partitions 

deleting, 175 


O 


online 

definition of, 453 
online help 

see help 
open files 

specifying number of, 294 
operating system 

see disk operating system 
organizing 

_ files using directories, 34 

OS 

environment variable, 88 
output 

appending, 80 

definition of, 453 

redirecting, 78 
overview 

of DR DOS commands, 113 
overwriting text 

(EDITOR), 68 


Pp 


page frame 
in expanded memory, 401 

paged memory, 401 

parallel 
definition of, 454 

parent directory, 36 

parity 
definition of, 454 

partitions, 170 
creating DOS extended, 174 
creating DOS primary, 173 
creating on hard disks, 172 
creating logical drives in extended, 174 
definition of, 454 
deleting DOS, 175 
deleting non-DOS, 175 
maximum size of, 170 
selecting bootable, 176 
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PASSPOINT (SID command), 422 
PASSWORD command, 55, 228-230 
passwords 
assigning, 56, 228-230 
definition of, 55, 454 
protecting directories with, 57, 228-230 
protecting files with, 55, 228-230 
global, 57, 229 
issuing, 56 
levels of protection, 55, 228 
removing, 58, 229 
and XCOPY, 270 
PATH command, 39, 231-232 
paths 
APPEND, 119 
definition of, 454 
displaying current, 134 
understanding, 38 
PAUSE batch subcommand, 100 
pausing 
text on screen, 28 
PC 
definition of, 454 
peripherals 
definition of, 454 
pin connections 
FILELINK cable, 188 
pipes, 80 
piping 
definition of, 454 
portable computers 
getting a visible cursor on, 151 
prepared code pages, 333 
preparing 
code pages (MODE), 220 
disks for use, 10, 170, 191 
primary 
partition, creating, 173 
PRINT command, 47, 233-235 
PRINTER.SYS, 324 
printers 
copying files to, 148 
setting up (MODE), 215 


supported by code page switching, 324, 335 


printing 
files, 47, 233 
using the PrtSc key, 196 
problems, 381 
error messages, 342 
with diskettes, 382 
programs 
definition of, 455 
prompt 
changing, 48, 236 
definition of, 455 
PROMPT command, 48, 236-237 
protected mode, 399 
protecting 
directories with passwords, 57, 228 
files with passwords, 55, 228 
data, 49 


Q 


QUERY I/O (SID command), 425 
queue 
print (changing), 234 
quick reference table, v 
quitting 
EDITOR, 63 
FILELINK, 187 
SID, 406 


R 


RAM 
definition of, 2, 396, 455 
see also memory 
RAM disks and RAM drives 
see memory disks 
RD command, 44, 248 
READ (SID command), 427 
read-only 
attribute, 59, 124 
definition of, 455 
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reading in a file 
EDITOR, 68 
real mode, 399 
real time 
definition of, 455 
RECEIVE 
FILELINK command, 185 
receiving files from a slave computer 
FILELINK utility, 185 
RECOVER command, 238-240 
recovering 
disks, 238 
files, 238 
files in EDITOR, 73 
redirecting 
I/O with CTTY, 150 
input, 80 
output, 78 
output to or from a device, 78 
and pipes, 82 
refreshing 
code pages (MODE), 225, 340 
screen display, 140 
relocating 
BDOS high, 317 
DR DOS kernel high, 296, 315, 321 
relocation table 
and EXE2BIN, 165 
REM 
batch subcommand, 101 
config.sys command, 301 
removing 
directories, 44, 248, 272 
files with DEL, 154 
files with DELQ, 155 
files with ERAQ, 163 
files with ERASE, 164 
passwords, 58, 229 
REN command, 46, 241-242 
RENAME/REN command, 46, 241-242 
renaming 
files with RENAME, 46, 241 
files with XCOPY, 270 
repetitive execution of commands (FOR), 95 


REPLACE command, 243-244 
replaceable variables 

and SHIFT, 102 
reports 

disk status, 136, 171 
reserved device names, 31 
resetting 

file time and date stamps, 260 
resident commands 

see internal commands 
RESTORE command, 53, 245-247 

error codes, 246 
restoring 

backup files, 53, 245 
Return key 

see Enter key 
RMDIR/RD command, 44, 248 
ROM 

definition of, 456 
root directory 

definition of, 34, 456 
running 

batch files, 85 


S 


screen modes 
ANSLSYS, 307 
values, ANSI.SYS, 308 
scrolling 
definition of, 456 
stopping, 28 
search 
for a string of characters (FIND), 189 
path (APPEND), 119 
path (PATH), 231 
SEARCH (SID command), 430 
searching 
for commands at the command line, 112 
selecting 
active code page, 132, 222 
alternate hard disks, 177 
bootable partitions, 176 
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code pages (MODE), 222 
configuration size, 12 
sending files with TRANSMIT 
FILELINK, 183 
serial 
definition of, 456 
serial cable 
needed for FILELINK, 188 
pin connections, 188 
session 
definition of, 456 
SET (SID command), 428 
SET command, 249-250 
setting 
BREAK on or off, 129, 283 
breakpoints (SID), 417 
buffers, 284 
up code page switching, 219, 335 


communication parameters (MODE), 217 


up communication ports (MODE), 217 
date, 152 
date format (country.sys), 286 
up a disk cache, 130, 310 
display type (MODE), 210 
up extended command line editing, 298 
global passwords, 57, 229 
keyboard typematic rate (MODE), 212 
lines, columns (MODE), 212 
up memory disks, 326 
passpoints (SID), 422 
passwords, 56 
physical characteristics for disk 
drives, 290, 313 
up printers (MODE), 215 
search path for commands and files, 231 
time, 258 
time format (country.sys), 286 
type-1 segment value, 439 
type-2 segment value, 440 
SETUP 
FILELINK command, 180 
SETUP program, 13, 277-278 
SHARE command, 251-252 
SHELL command, 302 


SHIFT batch subcommand, 102 
showing 


DOS environment (SET), 249 


SID, 405 


addresses, specifying 20 bit, 407 
ASCII characters, use of, 407 
assembly language syntax for A and 
Lcommands, 442 

character values, 407 

command conventions, 406 
command summary, 409 
command tail, parsing of, 419 
decimal numbers, use of, 407 
default segment values, 439 
definition of, 456 

hexadecimal numbers, use of, 407 
operators in expressions, 408 
quitting, 406 

starting ,,406 


SID commands 


2,411 
27, 411 

A (ASSEMBLE), 412 

B (BLOCK COMPARE), 413 

D (DISPLAY), 414 

E (LOAD PROGRAM), 415 

F (FILL), 416 

G (GO), 417 

H (HEXADECIMAL MATH), 418 
I (INPUT COMMAND TALL), 419 
L (LIST), 420 

M (MOVB), 421 

P (PASSPOINTS), 422 

Q (QUERY I/O), 425 

Q (QUIT), 424 

R (READ), 427 

S (SET), 428 

SR (SEARCH), 430 

T (TRACE), 431 

U (UNTRACE), 433 

V (VALUB), 434 

W (WRITE), 435 

X (EXAMINE CPU STATE), 436 


Z (DISPLAY 8087 COPROCESSOR 
REGISTERS), 438 
summary table, 409 
SLAVE 
FILELINK command, 182 
mode, 182 
software-generated cursor, 151 
SORT command, 81, 253-254 
stamps 
time and date, 152, 260 
starting 
applications from autoexec.bat, 330 
EDITOR, 62 
FDISK, 171 
INSTALL, 11 
other applications, 21 
second copy of COMMAND.COM, 141 
SID, 406 
stopbits 
definition of, 456 
stopping 
batch files, 86 
commands, scrolling, 28 
EDITOR, 63 
FILELINK, 187 
programs running (BREAK), 129, 283 
SID, 406 
storing 
text blocks in a file (EDITOR), 72 
strings 
definition of, 456 
searching for (FIND), 189 
inserting (SET), 249 
structure 
of manual, ii 
subdirectories 
see also directories 
definition of, 34, 457 
displaying directory of, 156 
SUBST command, 255-256 
summary 
config.sys commands, 281 
batch subcommands, 89 
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default segment values (SID), 441 
DR DOS commands, 113 
EDITOR keystrokes, 75 
installable device drivers, 303 
SID commands, 409 
switch 
definition of, 27 
help, 25 
pause, 28 
syntax of commands, 27, 106 
SYS command, 257 
system attribute, 59, 124 
system configuration 
changing defaults of, 277 
system disk 
creating (SYS), 257 


T 


TAB key 
in EDITOR, 64 

tables 
ANSLSYS screen mode values, 308 
ANSLSYS screen modes, 307 
BACKUP error codes, 127 
Batch subcommands summary, 89 
Character sets for code pages, 385-393 
Common file extensions, 30 
Config.sys commands, 281 
COPY device names, 148 
Country codes and code pages, 201, 287 
CTTY device names, 150 
Devices and redirection, 79 
DISKCOPY, drives supported, 161 
DR DOS batch commands, 26 
DR DOS command line editing keys, 110 
DR DOS commands set 113 
DR DOS external commands, 25 
DR DOS extended command line editing 
keys, 111 
DR DOS internal commands, 24 
EDITOR commands, 75 
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FILELINK, baud rates, 181 
FILELINK, cable pin connections, 188 
FORMAT, drives supported, 191 
Installable device drivers, 303 
National prepared code pages, 333 
Quick reference, v 
Reserved device names, 31 
RESTORE error codes, 246 
SID commands summary, 409 
SID default segment values, 441 
SID flag name abbreviations, 436 
technical details 
EDITOR, 74 
Terminate-Stay-Resident programs 
loading high, 197, 321 
text blocks 
working with in EDITOR, 71 
text files 
editing, 61 
time 
format, setting (country.sys), 286 
resetting file time stamp, 260 
setting, 258 
TIME command, 258-259 
timeout 
definition of, 457 
TOUCH command, 260-261 
TRACE (SID command), 431 
transferring 
control to another configuration file, 285 
DOS system files, 257 
files (FILELINK), 178 
TRANSMIT 
FILELINK command, 183 
tree 
duplicating on another disk (XCOPY), 270 
TREE command, 41, 262-264 
tree directory structure, 34 
troubleshooting checklist, 381 
TYPE command, 46, 265 
type-1 segment value (SID), 439 
type-2 segment value (SID), 440 


typematic rate 
setting, 212 
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unresolvable errors, 383 
UNTRACE (SID command), 433 
updating 

previous versions of files, 243 
upper memory 

appending to conventional, 315 

definition of, 398, 457 

loading device drivers into, 295 

loading programs into, 197, 297, 321 
using 

other applications, 21 

SETUP, 13,,277 
utilities 

definition of, 457 
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VALUE (SID command), 434 
variables 
in batch files, 87 
definition of, 457 
environment, 88 
and SHIFT, 102 
VCPI interface, 318 
VDISK.SYS, 326 
VER 
DR DOS command, 266 
environment variable, 88 
VERIFY command, 267 
version of DR DOS 
displaying, 266 
VGA 
enabling code page switching on, 312 
video memory 
definition of, 457 
virtual 8086 mode, 401 
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virtual disks Z 
see memory disks 
VOL command, 268 Z (SID command), 438 


volume labels 
characters allowed in, 203 
creating, 203 
definition of, 457 
deleting, 203 
displaying, 268 
modifying, 203 
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wildcard characters 
and backing up, 53 
definition of, 458 
global, 33 
in files, 32 
wildspec 
definition of, 106, 458 
working directory 
see current directory 
WRITE (SID command), 435 
write-protect notch, 7 
write-protecting 
definition of, 6, 458 
diskettes, 6 
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X (SID command), 436 
XCOPY command, 269-271 
and passwords, 270 

XDEL command, 272-273 
XDIR command, 274-275 
XMS, 
definition of, 401, 458 


